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PREFACE 

This manual is a guide to the sources and listings of the HP 2000 
Computer System. The source of the system can be used to make 
modifications to the system; the listings and this manual can be 
used to help understand the internal workings of the HP 2000 \ 
Computer System. 

This manual is divided into three parts. Part I >s a description 
of the physical format of the magnetic tapes (22703-10001-Listing, 
22703-10002-Sources, 22703-11001-Listings on 1600 bpi magnetic 
tape, and 22703-11002-Sources on 1600 bpi magnetic tapes) and a 
description of the BASIC program supplied to extract portions 
of the listings. Part II is the internal maintenance specifica- 
tions for the system processor. It includes details on the oper- 
ation of the system master program, the system loaders, the BASIC 
language processor, and the operating system. Part III includes 
details on the Input/Output Processor program and its configurator 



PART I 
SOURCES AND LISTINGS 



SQUtces 

The source listings are supplied as BASIC formatted files on a 
selective dump tape of account Z101. Each line of source is 
stored in one string. The files arei 



S2883 

S5ISS 

S7900 

S790S 

SASFH 
SPSTLD 
SC2883 
SC5ISS 

SC7900 
SC7905 

SCIO 

SCRO 

SCRC 

SCRSLD 

SD04 

SD110 

DS11C 

DS120 

SD12C 

SD130 

SD13C 

SD140 

SD14C 

SD2741 

SD274C 

SD274E 

SD340 

SD34C 

SD43 

SD50CO 

SD51 

SD530 

S053C 

SD61 



OXIMATE NUMBER 


QE_etoctss 


ttOQULE 


715 


System processor 1 




dr i ver 


725 


System processor 1 




disc driver 


715 


System processor 1 




driver 


725 


System processor 1 




disc driver 


228 


ASFH (IOP module) 


26 


Paper tape bootstr 


346 


Conversion program 


344 


Conversion program 




system 


346 


Conversion program 


344 


Conversion program 




system 


135 


CIO (IOP module) 


11 


CR0 (IOP module) 


85 


CRC (IOP module) 


7 


2100 Cross loader 


52 


O.04 (IOP module) 


11 


0.110 (IOP module) 


120 


D.llC (IOP module) 


12 


0.120 (IOP module) 


107 


D.12C (IOP module) 


10 


D.130 (IOP module) 


70 


0.13C (IOP module) 


10 


D.1^0 (IOP module) 


68 


D.14C (IOP module) 


115 


D.2741 (IoP module 



27 

27 

13 

214 

63 

278 

551 

9 

225 

332 



oader with 2883 disc 

oader with 7905/2883 

oaoer with 7900 disc 

oader with 7905/7900 



ao loader 
for 2883 disc system 
for 7905/2883 disc 

for 7900 disc system 
for 7905/7900 disc 



0.2/4C (IOP module 
0.274E (IoP module 
0.3*0 (IOP module) 
D.34C (IOP module) 
D.4J (IOP module) 
D.50CD (IOP module 
P. 51 (IOP module) 
D.530 (IOP module) 
0.53c (IOP module) 
D.61 (IOP module) 
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APPROXIMATE 




fc!£^L 


LEweie 


MOOU 


SD62 


62 


D.b2 


SD63 


200 


D.b3 


SDUHP 


29 


DUMP 


SHIO 


b2 


nio 


SHL'O 


14 


hLO 


SHLC 


1HU 


HLC 


S»- ,M 


54 


HMO 


SHPOI"» 


12 


MP 1 


SHMO 


14 


hKO 


SHh?C 


1S1 


hpc 


SICKH 


25S 


I Ckh 


si or 


248 


loc 


SIOPC 


lcf 1 ** 


10PC 


SLPO 


11 


LPO 


SLPC 


h* 


LPC 


SLTO 


8 


LTO 


SLTC 


2bb 


LTC 


SMC^^G 


8* 


Mast 


SMtMwY 


<*<* 


Mt*Mp 


SMM 


183 


MNj ( 


SMNRCD 


fh 


MNPC 


SMNWI« 


.117 


NtN'y 1 


SMtJXH 


68 


( lOP 


SPPO 


11 


PPO 


SPPC 


72 


PPC 


SPPO 


<s 


pPO 


SPPO 


4 


' PPu 


S^pC 


1S7 


HPC 


SSynCp 


214 


bYNC 


«;syni w 


jbh 


SYNI 


ST'-ifrd 


lb 


f HO.- 1 


sts;< 


7 750 


bySt 


sws'-'pri 


3h 


w*r m 



(IOP module) 

(IOP nodule) 

(IOP module) 
(IOP module 
(IOP module 
(IOP module 
(IOP moaule 
■i (IOP mooule) 
(IOP 'nodule 
(IOP module 

( IOP modu I*) 
(IOP moaule 

(IOP moaule) 
(IOP module 
( IOP modu le 
( IoP moou I e 
(IOP module 
er Proaram 
Y (IOP module) 
IOP module) 
(IoP module) 
h (IoP module) 

modu I o ) 
(IOP moaule 
( IO M modu I e 
(IOP modu.le 
( IOP modu I e 
( [dP 'ioau I e 
!.) ( Io p modu I e) 
H (IO M module) 

(IOP module) 
pm Processor 
sti»rt Droorem 



floorov i mete Total 19dvv r )isc kiocks 

The source code is mP cjioo ^sspho Iv lana«je?je # mm suoDortea 
asse^nlers are available for mP DOS and mp juOo systems. An 
assembler is available from the nP contriouteo library iop use on 
IHm J60/J70 systems. Care must be taKen to assure sufficient 
synnol table space exists* especially for the system Processor. 
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LISIIfcJGS 



The system software listings are supplied as BASIC formatted 
files on a selective dump tape of account Z102. Each line of 
the listing Is stored as a string. The first character of 
each string is actually a line printer CTL code which should be 
written to the line printer before the line in order to Insure 
proper spacing on the outout listing* 

The orogram LISTER has been supplied to produce listings for the 
user in the proper format. To use this program, log on to 
account Z102. Then : 

EXE-LISTER 
LISTER 

Enter name of module to be listed i XXXXXX 

Enter listing destination (Hit <CR> for terminal) YYY 



DONE 

XXXXXX is the name of the module to 
designator of the listing device. 

The f i I es are: 



be listed, XXX is the file 



APPROXIMATE NUMBE 


bfd&JE 


QE. 


.BLOCKS 


L2883 




1429 


LSISS 




1497 


L7900 




1429 


L7905 




1454 


LASFh 




191 


LBSTLD 




56 


LC2883 




79b 


LC5ISS 




795 


LC7900 




798 


LC7905 




797 


LCIC 




126 


LCRO 




12 


LCRC 




77 


LCRSLO 




13 


LD04 




42 



MODULE 
System proces 

dr i ver 
System proces 

disc driver 
System proces 

dr i ver 
System proces 

di sc dr i ver 
ASFH (I OP mod 
BSTLD (IOP mo 
Convers i on Pr 
Conversion Pr 

,Sys tern 
Conversion pr 
Convers i on Pr 

System 
CIO (IOP modu 
CRO (IOP modu 
CRC (IOP modu 
2100 Cross Lo 
D.04 (IOP mod 



sor loader 

sor loader 

sor loader 

sor loader 

ule) 
dul e) 
ogram for 
ogram for 

ogram for 
ogram for 

le) 
le) 
I©) 

ader 
ule) 



with 2883 disc 
with 7905/2683 
wl th 7900 di sc 
with 7905/7905 



2883 Disc System 
7905/2683 Di sc 

7900 Disc System 
7905/7900 Di sc 
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Ufl*E 
L0110 
L011C1 
LD120 
LD12C 
LO130 
L D 1 3C 
LH140 
L014C 
LD2741 
LD274C 
LO?7tt.' 

LD34C 

L043 

LD500O 

LDF»OT^ 

LDS1A 

LDM* 

LDS30 

LHS3C 

LOM 

LO*2 

U">*3 

LHIOCI* 
LH10IH 
LHLOCD 
LHLOl' a 
LHLCCi) 
LHLCIM 

LH"n)cn 

LHMOlrt 
LH^OCO 
LNPOI* 

LHPCCO 

LHUCIh 

LICKH 

LISTF* 

LIOC 

LlOPC 

LLpO 

LLPC 

LLTO 

LLTC 

LMCPPtt 

LMMMCf ) 



APPROXIMATE 

LEU&Id 

9 

lib 

11 

92 

7? 

9 
=»9 
9 3 
17 
19 
11 
1*0 

221 
21* 
520 
527 
<-• 
1H9 
Jl* 

6e< 
172 

27 

£2 

5<* 

1«* 

1- 
lb/ 
IdO 

5* 

S3 

13 

14 

14 
125 
127 
251 
1 
2b b 
1 Ob9 

1 1 

233 
lf>3 

37 
1*5 

hi 



(I OH module) 



tSODULt 

D.UO (IOP module) 

D.11C (IOP module) 

u.120 (IOP module) 

u.le'C (IOP module) 

u.130 (I OP module) 

D.13C (IOP module) 

D.1*0 (IOP module) 

u. l^C ( IOP moriu I e) 

u.2741 (IOP nodule) 

U.274C (inp moaule) 

D.^74(- (IOP module) 

l>,3<*0 (IoP module) 

U.J«+C (IOP mooul* 3 ) 

D.4.H (IOP moaule) 

U.tiUcn (IOP nociule) 

U.sOlrt (ICP moaule) 

u.sl for lo Dorts (IoP module) 

u.bl for 32 ports 

U.530 (IOP module) 

U # ->3C (TOP module) 

D.ni (IOP module) 

u.t-*2 (IOP mooule) 

l,t>j (IOP module) 

Ijum^ ( Inp moau I e) 

hto for coc (I OP nodule-) 
for IHM <ipP mooule) 

for COC (Top moouU*) 
for T pft ( IoP moaul e) 
( Inp moau I e ) 
( Top moau I e ) 
(IOP module) 
( IOP mcau I e ) 
(IOP ^ooule) 
( IoP moau I r» ) 
( IOP noeiu I «M 
( IOP mocu I p ) 
( IOP modu I e) 



hi 
hlu 
Mlo 
HLC 
HLC 
hMu 

HUH 
HP u 

hpc 

nPC 



for 
for 

for 
fnr 
for 
for 
for 
for 



CDC 
I mm 
CDC 

It-M 
IHM 
CDC 

CuC 

IhM 
lCKh (IOP module) 
Pronram to produce 
loe (IOP module) 
lOPC (IOP moaule) 
LPO- (IOP mooule) 
LPC (IoP module) 
LTO (IoP module) 
LTC (lop moaule) 
castor Proar^T 
*.£M9Y (IOP module) 
mn ( IOP moau I p ) 
MmwC!) ( InP moau I e) 



I i s t i nos 
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UAUE 


LEWfilb 


LMNRI6 


101 


LMUXH 


65 


LPPO 


10 


LPPC 


69 


LPPO 


5 


LPPO 


9 


LPPC 


132 


LSYNCD 


197 


LSYNIH 


328 


LTBOH 


15 


LTSR 


8257 


LWSPPG 


84 



MOQULE 

MNRIH 

MUXH 

PPO 

PPC 

PPO 

PPO 

NPC 

SYNCO 

SYNIP 

TftGH 

System 

warm s 



(I OP 
(IOP 
(IOP 
(IOP 
(IOP 
(IOP 

(IOP 
(IOP 
(IOP 
(IOP 

oroc 
tart 



modu I e) 
modul e) 
modu I e) 
modu le) 
modu I e) 
modu I e) . 
modu le) 
modu le) 
modu I e ) 
modul e) 
essor 
proqr am 



ADorovimate Total 24987 Disc blocKs. 
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INTRODUCTION 



The 2000 System consists of several 

separate programs which are run on two processors. The I/O 
Processor Program is responsible for handling all multiplexed 
I/O from user terminals* for I/O to optional non-shareable 
devices and for remote system data communications. 
The system contains the BASIC interpreter* executive* and library 
routines and runs on the main processor. The Loader* which also 
runs on the main processor* is responsible for generating 
initial systems* backing up the system on mag tape* reloading 
the entire system and user library* and selectively reloading or 
backing up users* libraries. The Loader also contains the cold 
dump routine which i sa used to dump the contents of core from 
both processors* as well as selected portions of the disc* to mag 
tape. 



hardware Configuration 
I. SYSTEM PROCESSOR 



10-11 Processor interconnect 

12 System console 

13 Time base generator 

14 F irst di sc 

17-20 Mag tape (can occupy any unused select codes) 



II. I/O PROCESSOR 



A. See the operator's guide (22687-90005) and I/O 
processor IMS for details. 
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I 



USER 
PORT 



MODEMS 



nt 



s-Ofc 




<e 



PHONE 
LINES 



MULTIPLEXOR 




i> 




/ 



M 



I/O 
PROCESSOR 



INTERCONNECT 
> 



SYSTEM 
PROCESSOR 



">I PHONES 
AUTO 

DISCONNECT 




DIAGRAM OF S *;M HARDWARE 



COfifc-MAB 



APPROXlMATfc. 
OCTAL 
LOCATION 



100 

200 

User 1231 

LIBUS 1235 

24000 
26000 
27700 
30401 
30451 
31571 
31605 
54600 
57414 
60000 
60447 
62641 
6*000 
65417 
70000 
71200 



Interrupt linkage ana uninitialized system 
variables 

Equipment table 

Constants and system var iaotes 

Registers saved by clock 

User swap area and system library work area 
(10240 words from 2000 to 25777) 

For disc resident salvage routines 

Disc driver 

Device table 

IDEC 

DIREC. 

ZDISC (disc driver driver) 

BASIC 

Formatter 

Power fail/Restart routines 

System console driver 

Teletype tables 

I/O processor communication drivers 

Magnetic tape driver 

System failure* retry* and salvage routines 

Schedul er 

SWAPR 
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Llb^A 



71670 
72242 
7bUO0 

77000 



Command table 

System library subroutines 

System library programs swap area <bl2 
words) 

Co I d dump 
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MASTER PP013PAM 



I. INTRODUCTION 



The Master Program (M.p.) supervises the generation or recon- 
figuration of Access systems invoking the desired configurator 
(Iop configurator or Tsb System Loader) and Providing them with 
utility services. The M.p. is bootstrapped into the System 
Processor (SP) memory initially from the Master Tape and there- 
after remains resident until loading of the SP program. Since it 
contains drivers for the system console and magnetic tape unit* 
the ^.P. is stored onto the disc along with the TSB System Loader 
so that it can be recalled for service during system shutdown. 

Programs intended to be co-resident with the M.P. must not alter 
the following areas of memory during their execution: 

a-7: Iaentical with the values used by the TSB 
System Loaders and the TSrs Svstem Program 
(except that the latter changes location 4 to 
enable power fail recovery). 
30 (8)-77(8) : : M.P. temporaries and linkage locations. 
2000 (b)-3777(8) : Contains the M.P. code and system console 

buffer. 
MAGSC: Contains the magnetic tape unit select code and 
system console type. This corresponds in 
location to part of the SP orogramis equipment 
table and will be In the range 100 (8) -177 ( 8) . 

Additionally, a call to the 'find Id* routine (JSB 75B«I) will 
use a buffer origined at 300(3)* Potentially extending to 477(8). 
Complete safety can be assured by using only locations 
10(R)-27(B), 1000 (8)-1777(8) * and <*000 ( 8) -77677 (8) . 



A orooram I oaoed in resoonse to the "LOAD WHICH MODULE? 1 ' guest ion 
is invokea by a JSB 4U00B. Such a program can r etur ncontr ol to 
the m.p. after completion with a JMP 4000b»I. Certain errors 
detected by the M.P. will cause it to rewind tne Master Taoe and 
restart itself with the ••LOAD WHICH MODULE?" guest ion. 

The following services ^r e provided by the M.P.: 

1. Magnetic taoe unit driver (see listing for calling sequences) 
-invoked by a JSb 77h«I. 

?. Svstem console ariver (see listing for calling seouences)- 
invoked by a JSd 7hH«l. 

3. »Fina id recora* on Master Tace - invokea oy a JSb 75B*I 

with tne id number of the desired recora in (A0 and zero in 
(H). (A -1 in (b) is used under special circumstances ay the 
TOP Configurator only). Modules should assume that only a 
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s i no l e secuentiai opss * i I I he ma 

c . • ^ e ft « 6 orta rucir'i' — invoxeii b v 
ff'ici'-fcss |n (r), "l ne *.P . /.'ill de 
the faster Taoe Id recoras are de 
records r«p| ivoroc, This routine 
tKo moaner ic tcif^v nv somp oreviou 
rororo', The records t^-us read a 
nenorateo ay an i-ir* Assemoler and 
In ir-noth, udct; return (a) no Ids 
npoet ivp woras or is zero i f an e 
rout inc automatically bacKSoaces 
r j l Is will rrturr. (u)=u until »fi 
to resit ion IHc t cop to another f 
r^locst^nle -rino cnsolutP r»rords 
orrcr? /.ill ?njr [ tne ororr-ss, 

^ . Location /.^' no Irs t no rcinross of 
worn referenced *i I I ^r 7pro un|p 
oier'ition ft ■its hen oast the t-' QT m 

n. after return from an inout reoues 
console, lot.it ion /^* J .* i ll contai 
tne response strir. j (0 Xo t d cnar 
Cdrr iacp-ret'.rn), ^ince this *or 
rnriyles r. r*" freely alter it as no 

7. At tor return from a 'read data re 
I nca t i on / 1 -« « i I I contain a cony 
tuODl ten in (H) Lv t no caller. q 
with each c-j I I % nodules can alter 
*n extraction pointer* *nvancmo 
of the r^corn reac) . Caution: a 
r<\cor<~.* (jb l - 7b»-«i) *lso alters t 



cif tnrouan the Master laoe. 

a j«h f<utfml witn a buffer 
I iver tne next record from 
leted from tne stream of 
oresuocoses .adjustment of 
.s invocation of »find in 
re presumed to have been 
tnus to oe t><* or fewer words 

the record lenqtn in 
nd-of-f i le occurred (tne 
over tne f-70f-"» suoseouent 
nd in record 1 ' is usem 
i I o ) • CnecKsums for ooth 
ere cn-f.CKeOi Checksum 



tno end-of 
ss tne last 
AC" of tne 
t a i rected 
n a Charcot 
^ctprs foil 
n is reset 
s i rva • 
cord* re ciue 
of tne ruff 
i nee this w 

i t ( t or ex 
i t af ter I o 

ca I I to ro 
his I or.-it i o 



-taoe f I rio, Tne 

maqnet i c taoe 
trtoe. 

to tne system 
er pointer to 
owe a oy a 
w i th each call, 

S t ( JSo /n-d* I ) * 

er address 
oro is reset 
amo l e# use » t as 
adinq each word 
utine » f i nd id 
n. 
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Conventions fcr us^ of Io ^ecorrs 



Strict a^f-or pne-' to tno forv^nt ions outlines here rir e not 

r ecu iron for pro tor functionina of tne master conf i duret i en 

stratoov* cuf tno,r >.ij»f c-rcvioe« a consistent eooroacn with 

maximum Hrxim I i tv for future cent i naenc I es . 



a. 



Pile format 



1) All filos .'?*ceot thp Master Program ani tne Confidureo 

1 OP or nor am n I > snouli r^^.v^ the fol lo*inq format: 

a ) F i I :? i a r ecor a. 

r- ) one or .more <-iata ctoups (all ansolute or all 

r p I oca tec I e ) , 

c ) hnr 1 m recori, 

n ) f- nn - *." f — * I I r-> r *r « • 
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2) The Configured loP Program file must have the format: 

a) File ia record (id number is 65000(10)). 

b) one or more date records in a format suitable for 
transmission to the lOP»s Protected loader or 

no records if no confiqured I0P Program exists on 
the tape. 

c) End-of-file mark. 

R. Patch tape format (recommended) 

I) Master id record (id number is 0). 

c?) One or more data arouos in ascending id number order, 
(both absolute and relocatable data groups can be 
present on the patch tape). 
J) End id record (id number must be ^5535 =177777(8)). 



C. Data group format 

1) Group ia record (bit 15 of info word = 1 if NAM 

record follows* u otherwise). 
^) None or more data records. If the data group is 

relocatable* the records from one complete program 
unit beginning with the nam record and terminating 
with the End record? if the data group is absolute, 
each record is in the standard aosolute binary form. 

The use of id records for relocatable modules is straightforward. 
The assembler outout for each separately assembled proqram unit 
is orecedea by an ic record, formino a data group. Such a group 
Is a complete subpart of a patch tape or is combined wjth other 
grouos into a file on tne Master Tape. 

The use of id records for absolute modules is somewnat arbitrary; 
the number and Placement should be chosen to facilitate genera- 
tion of correction records on a Patch taPe. Id records can be 
conveniently generated as oart of the absolute assembly by s I tua- 
tina them just prior to each ORG osuedo-s tatement of the program 
proper (i.e., just pefore tne END statement). Of course, each 
orouo of absolute records on a oatch tape should be preceded by 
an jH record to indicate where they should oe merged during 
aeneration of a new (i.e. patched) Master Tape. 



III. I/O Configurator MethOdOloay 

To configure an loP proaram: 

1) call tfind id* routine (JSB 7ba*I) with (9) - and (A) = Id 
number of standard modules file (2000(10)). 

2) Read the file sequentially by calls to 'read data record7 
(JSB 74B»I with (b) - buffer address) until the end-of-file 
is reached ((40 — on return). 
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?) Position tno Master Taop to tne ODtior.al modules file by a' 
jSh 7bb»I with (ti) = anci (Ao = .3000(10) (id numoer of 
oct ional modules file). 

M ^eao the file seouentiallv oy calls to "read data record* 
(j^r /'m-H.I with io) = buffer address) until either the 
nnn-of-filo is recchpo ((A) - on return) or all desireo 
modules have been roio. 



nroaram is to oe written on the 
b oelow. otherwise oroceed to 



thf? conf ioured l')P file by 
bbUOO(lO) (id number of 



a JSb 



If * conHQurf'3 ccoy of the IPP 
Mflstpr Tace* continue * i th stt.?P 
St^o 9. 

^) Position t^e haste*" T*cr to 
7b. I with ^u = -1 ^no (A J x 
Conf ioured I qh ♦ i I *• ) . 
M write th? confiourn jc.p nrogram usinv} oirect calls to the 
m-ionftic taoe criver (jS**. f7**l0. hefore attempting to 
*r i i<> each nata record* check the eno-of-taoe flag (73S-*l). 
I <• it is non-zero, issue a rackf i I e/f or war d recoro request 
tot urae tne file ^r iiteo so far- 
CCC bacKf i I e 
CLH.iNi forward one rp-coro 
JSh 77-1*1 reauest action 
OCT <* (dos i t i on i no, reauest) 
rs'pp these returns 
NOP wi I I not oe tdKen, 



rnen issue -» riaanostic and proceed to steo 7 below. 
Note: If too cnecK for a write r i no is made by a status call 
to thp drivrr before oerfor^nna steo b • tne coding of the 
•tester Proar-:m will allow dismounting the taoe and remount inq 
it *ith a *nte rioo. a rewind should tnen be issued to en- 
sure tape is at I oa-) oc i nt • 

I) '*ntf an i?nd-of-fiie mark (this is to dp done even if the 
nno-of-t <*po fla^ is sot) and backspace over it. (A) = a 
convenient id nurrrpr (the id number of the 10P conf iaurator's 
onn id record* presumably 1^9(lu)» will ao nicely). 

m) upturn to th<? M,p. ^ith a JV>h <»000o*l. 

To ro*ci a cort icu^ec Iop orocr^n fron the Master Tape: 



1) 
?) 

H) 



iOP file by a JSb 



Position tne taoo to tne Configured 
7bH*J with (r>) = -1 ana (a) = obuOJ(lO). 

tne file usinc direct calls to the magnetic tape 
- ' "" ■* "* After the eno-of — file marK is re, 

no rocoros were read* tnen no 

on tne Master Tape* inform 



read* 



Head 

or i\/er ( j$r ? /*, i ) 

nackspace over it. If 

confiaurea lor orouram exists 

t no ooer ator . 

deposition the t^oe by a JSH 7bh * I 

(M - c convenient id number (4.Q.* 1^9^(10.) as in steo-B 

oCOVP ) . 



with (Hu = -1 ana 
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*>) return to the M.P. with a JMP 4-0 0B,! 



IV. ID RECORDS 



An i d 


record 


i s 


exact I y f i 


form: 










word 


o: 


lOOOti 




word 


1: 


2001fc 




word 


2: 


10 number 




word 


3: 


Info wor.i 




vkcrd 


4: 


ChecKsum 



long ano has the following 



The Id number is a 16-oit positive Integer (0 < Id < 65535). 
Eacn file on the master configuration tape must oegln with an 
id rucorc* whose id value is a multiple of 1000(10) (allowing up 
to 6£> distinct files on the Master Taoe: bit 15 must be set 
If the id recoro precedes a NAM record (i.e.* is the group Id 
of a non-null relocatable data group). In all other cases it 
must be zero (absolute data grouo) . This convention is useo 
to determine which of two checksums to calculate as records of 
a module are read from the Master Taoe. An absolute checksum 
chec* oe-r formed. No checksum check is performed on records of 
the configured IOR since these records are In core Image format. 

id 



Thp fol lo*ina absolute Drooram fragment wi 


i 1 I aenerate a 


record: 








OkG 200 IB 








APS IDVmL 


1UVALUF 






DEC 


INFO WORD 




hSS 1 


FORCE END OF RECORD 




Currently assigned f 


i 1 e id 


numbers are as 


f o I lows : 


FILE 


ID NUMBER (DECIMAL) 


DATA FORMAT 


I0OP CONFIGUWATOW 




1000 


ABSOLUTE 


IOP STANDARD MODULt 




2000 


RELOCATABLE 


IHP OPTIONAL MODULES 




3000 


RELOCATABLE 


WARMSTART 




7000 


ABSOLUTE 


7900 LOADER 




10000 


ABSOLUTE 


2883 LOAOER 




11000 


ABSOLUTE 


790S/7900 LOADER 




120J0 


ABSOLUTE 


7905/2883 LOADER 




13000 


ABSOLUTE 


TSH SYSTEM 




20000 


ABSOLUTE 


7900 FILE CONVtRSlON 


2b000 


ABSOLUTE 


2*«3 FILE CONVERSION 


26000 


ABSOLUTE 


790S/79u0 FILE CONVERSION 


27000 


ABSOLUTE 


7905/2883 FILE CONVERSION 


2d000 


ABSOLUTE 
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r;or>" i ' .1 .'kt;.i.i i CtW 



v. 



masti-p lAPh' 



Thp contents of tn? ma 
f i l»s. e?rh foMowea b 
f M o is tne Master (-ro 
absolute Rir^rv format 
dat* core's* ana cheens 
tfioo; thereafter it ur 
figuration moaules, 1 
the file in re cor n . 1 
program throucn rtn oat 
filos are the I<;h» coot 
I O-y-i^r s « thP ACChSt> Sy 
Each of trese files co 
data or ours* ami an op 
dfll^ ",rour> consists Of 
abl« orouo (NAM re cor a 
absolute rinsrv for me* I 
orouo recoro may oe fu 
end— of— file marK ) . pi 
^extinctions aoove ere 
unioue intecrr (id) *h 
Physically preceding i 



ster tape for ACCESS c° n sist of R«-2 

y r\r\ ena-of-file marK. The. first 

ar am • composed of a soouence of recoras in 

(number of data worns • memory or i q i n * 
urn). The ^.P. must be loaded from map 
ovioos the facilities for loaoina the con- 
he last file is initially emoty except for 
t can be overwritten vitn a confioureq IOP 
ion of too lr,(-> Conf i <jur at or » Tne middle n 
i-urrjtor» \oo proqran moou I es, war mst er t • 
stem* rjnd t*e file conversion modules, 
nsists of a file id record* one or more 
tional* but recommenced* end id record. A 
t oroup id recoro followed dv a relocat- 
t^rouon EnD recoro)* or sequence of 
records* or a null record set (i.e.* a 
I I o*ed oy anoto^r io recoro or the file's 
I id records have the sa^e format, the 

functional. F-ach ic recoro contains a 
icn nust oe oreater thr->n the id of the 
o record. 
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Qe I oca tab I e File 



Aoso I ute File 



File id 
Record 



File id 
Record 



Group id 
Record 



Group id 
Record 



NAM 
Record 



FIRST 
Data Group 



ABSOLUTE 
Record 



fcna 
Record 



Absolute 
Record 



(-roup id 
Recora 



Group id 
Record 



NAM 

Record 



Last 
Data Group 



ApsoI ute 
Record 



End 
Record 



Abso I ute 
Record 



Ena id 
Pecord 



End i d 
Record 



EOF 



EOF 



VI. 



Patching the Master Tape 



The Master Program does not support Patching of modules using 
a oaoer tape containing patches. However* the Master Tape can 
be directly patched in the following manner. 



2-1 



The old Master lace mav ne nerpen with a patch taoe creatinq a 
new w»stpr TeDe, Mssumino that the oaten tape follows the 
conventions for id records* the ne*| v created Master Taoe will 
contain the new Patches* Hence when any module is loaded tne 
oatcnes have a I r eaay , been included. Note that the software to 
do this i.s not part of tne ACCfcSS system itself and the Master 
Proaram can not tie Patched as it does not contain an ID record. 



y II •--LQcaiDS-tbs-tJosisc- Be cgc«c3_QD_s-cJi«y-_ie5e£i-s its rec* 

whenever it is desired to use the Master Hroaram on a dlOQ based 
svster for whatever reason: system rrash, ch^naing IOPs* system 
uDd*ttP« etc, the followino procedure should oe followed. 

The onjective is to re^h the Master Program from -nao taoe usinq 
the m^a tace bootstrap contained on oaoer tfloe. Fnis oootstrao 
must he cross-loaded from the I()P to the system orocessor usinq 
thr» flr.CKSS cross loaoer since the svstem processor has no pnoto- 

The cross loader must be re&c. from special ACCtSS nasic Binary 
Loader, Hence to reload the system orocessor. the 10^ must oe 
clonheren witn the crossloaoor. Obviously the ioP must be 
reloaoea prior to reloadino tne system orocessor. 

The nao taoe bootstrap, once cross loaded into the System 
o»-ocessor, may oe used twice. once to loan or reload the IoP 
and once to reload tne system processor. 



dlOu Cross Loader 

The *»r:CfcSS Cross Loaeicr binary resides on tne first file of the 
Cross Loader /Poot strap o^oer taoe. The Cross Loaoer is read from 
the inP*s paper tape roa-ier us mo the ACCESs protected basic 
Rimrv Loader. 

once tne cross Loaoer n^s neen read into tne loP's memory the 
contents of the a and n reoistcrs should not oe altered as they 
contain the select cones of the Paper tape reader and the inter- 
connect Kit, The ACCtSS orotected loader conveniently sets these 
reoisters for tne Cross Loader. 

To coss load the poctstran (or any orenran), str»rt tne system 
processor *s protected loader (reaoino from tne interconnect kit). 
On the IoP* o l ace tne proaram in the onotoreaoer and set P = d 
and Dress ••run". A halt 77n on noth orocesors s i qna I s a success- 
ful cross loao. Tne Cross loader may oe restarted after a halt 
77R hy simply Pressinu "run" if it is desiren to cross load 
anntnor- crooram. 
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clOO vag I ape Boots trap 

The maa taoe bootstrap is the second file on the crossloader/ 
bootstrap paper tape. The crossloader sends tne bootstrap across 
the interconnect Kit to the system processor where It is read and 
Placed into memory by t the protected loader. The bootstrap may 
then be started at either 2000b or 4000B (20008 contains a jump 
to 40008). However, if the bootstrap has just been used to 
reload or configure the IOP it must be started at 40008 the 
soconn time. This is reauired because the IOP configurator 
destroys the jupid at location 20008. 

Once tne execution of the bootstrap is started* the user is 
promoted at the console for the select code of mag taoe unit 0. 
Valid values are 14b thru 266* 

The Master Program is then read off of mag taoe and loaded into 
memory. At this point the taoe is rewound* the select of the 
maa taoe is Placed into bits 6 thru 11 of the switch reaister 
and the execution of the Master Program begins. 

2100 IOP Basic Binary Loader 

The loP on 2100 based systems contain a special ACCESS version of 
the protected basic binary Loader. Consult the Loader manual for 
procedures for loading this loader. 

This loader has two starting addresses for each of three possible 
memory sizes. To reaa from the interconnect kit? start the 
loader at location X7700. To read. from the paper taoe reader 
stgrt the loader at location x77b0. 

where X=7 for a 3u K IOP 
X=5 for a d4K IOP 
X=3 for a IbK loP 

In either case* successful execution is indicated by a halt 778. 
If successful* the select codes of the Photoreader and the 
Interconnect Kit are left in the A and 8 registers respectively. 
These register settings are required by the Cross Loader. 
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2000 ACCESS LOADERS 

There are four loaders available for 2000 ACCESS systems. 

The specific loader to be used depends on the type of 

discs on the system. All loaders are functionally eaujvalent 

There is a unique ACCESS loader for each of the followig 

combinations of discs: 

7900 only 

2883 only 

7905 and 7900 < 

7905 and 2883 

Note that all other combinations of discs on a single system 
are exPlicity disallowed. All subsequent references to 
••Loader" Imply all four* unless explicity noted. 



The Loader is a separate program which runs on the system 
computer. it is explicitly loaded by the operator to perform 
the following functions: 

1. Generate a new system from maq tape. 

2. update an existing disc-resident system from mag tape. 
3.- Peloao a system from magnetic tape. 

4. Reload a system from disc using the master tape* 

5. uporane an ACCESS 1A svstem to an ACCESS IB system. 

The loader is implicitly loaded when the operator requests any 
of the following functions: 

6. A normal load from disc of a slept or warmstarted system 
uslno the disc bootstrap loader. 

7. A sleep or hibernate. 

In addition, the loader contains the moving head disc driver 
for the system* the cola aump bootstrap* and cold dump program. 
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GENERAL DESCRIPTION 

!• iBi£ial_SYStem_Generation 

Thr Loader Generates the system tables ©y as*inq the 
configuration option questions. If no options are specified 
then it sets the tuT to default values: 1 disc on the system* 
h diectcry tracn oer aisc* and 1 ID tracK. If tne system discs 
are exclusively 7s;ous tnen the default is 1 directory trac* 
oer disc. 

Discs fire checKea for lands. The Locked bloc<s fable Is 
initialized to zeros on I v when the disc is not labeled for TSr> 
and me operator wants it to he labeled. 



Th^ nisc space c I a i m i no strateoy is as follows: First build all 
Af)T»s in core fro"i LocKea Mocks Tables. Tnen claim disc s°ace 
for tne svstem* lf;'ls* ADTs and directory traces usina the AQTs 
in core* ^hich &r e tnen written to disc. (The disc space 
reauirea dv system library routines and user- swao areas are 
clai^eo after the first system linrary routine is read in because 
th^t routine is a table of the lenaths of all the system library 
routines, according to which the disc space for the liorary can 
he commuted ano clasmen. 

The TOT* ADT ana directory traces are J<i contiauous clocks each 
and the swap tracks dre **?. contlouous dIocks each. 

In order to minimize cylinder s*i tcnino. the following algorithm 
is used for claimina cisc soace for tne system taoles and swao 
tracKs: 

•*. bet the next uie.ee of availaole disc space. 

r>. If it dees not cross Physical cylinder boundary* 

take it. 
c. If it crosses Physical cvl inner rouniary tnen take 

the n<=xt Piece o *■ availaole nisc s»ace wnich starts 

on physical cvlincer nounaarv. 

This sinale algorithm works for all idisc tvoes. 

The rationale for oe i m anle to hu i I d all ajT's in core at i^oUb" 
Nor is each ana to heve them remain memor y— r es i aent while claiminq 
disc soace is as follows: 

A. K^ch ADT is ouilt from Locked hiocks Tarle which is i olock 
I ona (£Sn woras) cont^ininq at most ldr entries* or 3d7 
w orris (3 wor as/entr y ) . 

R. Therefore eacn initial &\)T has at most IdM entries* or -Sb 7 
words (J wor as/ent ry ) . 
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C. When claimlna space for the system segments, the number of 
AnT entries will not increase because they do not have to 
start on cylinder boundaries so that the aqt entries are 
either shortened or removed. only claiming space for IDT, 
ADT and directory tracks may cause an increase of ADT entries 
because they have to meet the cylinder boundary conditions. 
The increase of ADT entries is at most: 

3<IOTs) + b (ADTs) + 10x8 (directory tracks) a 91 entries 
or 2 73 woras. 

D. Hence each ADT buffer needs at most 367 + 273 words = 660 (or 
1224p) words. 

E. Picking a nice even number* maxe It 1400B words long each. 
Then the buffer length for B ADTs is 140003 which can easily 
fit in memory starting at 32000B. 

The system is read from mag taoe and remains in memory. After 
the first system library routine is react* the system segments 1 
and 2 occupying locations 3H0G0b through 52000B are written out 
to the disc so that this oortion of memory can be used for ADT 
buffer when claiming disc space for system library and swap 
areas. (The other system . segments are written out after the 
CfM*> . table Is set up.) 

when all the system binaries are read* the remainder of the 
system is written to the disc. Then the pre-boot processor 
ano final aisc bootstrap are written to each disc; the system 
segments are restored in memory* the user swap areas are 
initialized ano tne DATE-TIME sequence is entered. control 
is then transferred to TSB. 

?. System UDdate 

System uogate uses only the system binary load section of the 
load sequence. however instead of generating the EQT» it 
reads the EOT from disc. It returns the disc soace occupied 
bv the original system library to ADT and claims new disc 
soace for the new library in order to allow expansion of 
system library as well as possible saving of disc space. It 
does not change any disc area other than the system code. 
Selective load ano dump is processed before entering the 
DATE-TIME sequence. 

3. Mag Tape Reload 



Mag tape reloaa reads the EOT a»nd DIREC from the hibernate 
or sleep taoe rather than oeing initialized. Also, before 
the system is read* iDTs and directory tracks are read from 
tape and distributed evenly on .disc. 
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'ifter the svstem has neen written to disc* tne user library 
is loaded and stores on disc accordina to tne allocation 
oot i on spec if led. 

Selective LOAO/Dun.p is processed before entering the DaTE- 
TlMh. seauence. It is described further in tne Selective 

Locd/Dumc Section, 

4, ni sc ^e I oaos 

Tnere are two procedures to reload a system from disc, Tne 
loader is explicitly loaned .into memory for one Procedure 
and i mo I i c i t I y loaded for tne other. Tno latter will oe 

pypldineci in item *■>.' 



The Master Tape must 


or na<A tape reloaa is 


Control is transferre 


*here it reads me oi 


'd . After cnecKinL, fo 


system according to s 


ootions* returns the 


for new swap areas, d 


and enters tne DATE-T 


from disc) is not i n 


attempted, otherwise 



no usen, if neither system generation 

specified* a disc reloaa is implied* 
d directly to the section of the loader 
sc bootstrap and SST from blocks I and 
r valid conditions* it reads in the 
5T, Then.it processes the configuration 
ola swap nre& to ADT* claims disc sogce 
rocesses selective LOAD/DUMP commends 
IN-E seauence. If the system (as read 
a 'slept* state* warms tart may oe 
the reload is aborted. 



ACCESS-lA Upgrade. 
_ ^ 

Tne loader ( ^CCr. bb- IH) knows that durinj a maa taoe reload 
it may ne reloading an ACCESS-1A system. If so* special 
proccssmo is reguireo. The followinq snoulo have occurep 
orior to attemptino the reload, 
1, Reconfigure the system processor onn I/O processor 

nardware as reauired, 
'd » Conflaur* an Access Ir* 1/0 processor. (It must be 

r unn i nq . ) 

r )ur i nq the m.^q tat>e reloaa* niscs other than disc 0* must 
reconfigured using the OISC commana. The differing system 
level codes &re ignored. After the opportunity to perform 
LOAD or DU^P commands tne system halts /7n* instead of 
noino throudh the normal date ana time seauence. At this 
ooint in time* the software is IA (as far as the system 
arocessor is concerned), and the hardware and I0P are 16, 

in order to install tne IH software* set P=^U00y and press 
run. The IB master taoe should he I oaoea ana a system 
uDaate srecif iea. This completes the uuarade to ACCESS-IB. 
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P.i§2-Bootstra]3 



The loader is entered implicitly through the bootstrap 
oroceoure: 

A. The memory or ROM resident disc loader reads in 

sector .of f disc into memory starting at location 
2055B* entering the pre-boot. processor. 

p. The pre-boot processor reads in the disc bootstrap 
and SST from blocks 1 and 2 of disc into core 
starting at location 145008 and jumps into it* 

C* The disc bootstrap then reads in the system according 
to SST and the same seouence of events occurs as out- 
I i ned in I tern 4. 

7. Sleep or Hibernate 



For a normal sleep or hibernate* the loader is read into 
memory according to SST by the system library routine and 
control is transferred to the loader* It first copies the 
DIRfcCT and EOT to disc and then if DUMP was specified, it 
starts the mag tape dump orocedure* If RELOAD was specified. 
a disc reload is Performed (see item 4), If no option was 
specified* it just halts with 77b (SYSTEM SHUTDOWN)* 

The sequence of aumoinq is as specified In the sleep/ 
hibernate tape format section, if sleep* the user files 
dumped are only those chanqed since the last hibernate; if 
hibernate* all user files are dumped* 

R. System/Feature Level Codes 



Each system and loader is assigned a system level code un- 
uniquely identifyind that system (but not* in general* dif- 
ferent versions). Fach time a system is loaded* the loader 
will ensure that it is the correct one for that system. 

A. on initial system qeneration or system update the loader 
will verify that the mag tape contains its system level 
code* 

fl. on magnetic tape reload the loader will verify that the 
set of tapes was generated by its system* The only ex- 
ception is an ACCESS-1A upgrade (see item 5). 

C* on disc reloads (bootstraps) the loader will verify that 
the system on the disc Packs is its system* 
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If the system is not acceotaole in any of the aoove. the 
loeaer will orint ILLEC7AL SYSTEM CODE • LOAD/DUMP 
ADOPTED on the system console* enn terminate loading, 
of course* this should never occur. The system level 
codes assigned are: 

2000C (rti Qn-SDeon) ^000 

2000F (notion cuo/20S) 3000 

20 Of* (notion 21U/21b) 3^00 

2000 Access helease A bOOO 

2000 Access Release P faOoO 

The values flre independent of the feature level codes 
described oelow. 

E*ch svstem is also assianed a feature level code identify 
ina the level of features it suooorts. 

2000C (Hicjh-SPeed) 200 

2000F (Ootion 2U0/2OS) dOU 

20u0F (OPtion c;10/21b) dvu 

2000 Access release A iOOu 

2o00 Access Release H *oou 



The assumDtlun is that all systems *i I I be maintained as 
concentric sunsets* nut t ne scheme is flexible enough to 
anrooate tnis if necessary. The feature level' code is 
usee by the loaoer to ensure that a system is not loaded 
with' a library cent a i n 1 nc Droarams with features it does 
not suoDort. when selectively. loaaina orograms and files 
from maonetic tapes* 1* the tabes were oroduced by a system 
with a hicner feature l»=>vel the loaoer will orint: 

TAPE MAY CONTAIN FEATURES NOT ^uPPOPThO ON ThIS SYSTEM 

( xxx VS v vy ) 

UO YOU TAKE PESPhNSInlLlTY .' 

If the operator answers NO* the rpguesten selective loaa is 
nypassed anci the loao op hump commands? message reoeated to 
allow loaning to continue. If the operator Knows that in 
fact none of the Programs or files to ne loaaeci contain the 
extra features (xxx is the feature level code of the system, 
yyy is the feature level code from the magnetic taoe) * he 
m^y answer YES and the selective loan will be performed. Any 
other answer will cause repetition of tne message: 

00 YOU TAK(- KfSPnNSlnlLlTY? 

when performing .a svstem update* if the feature level code 
o* the o 1 sc-r es i aent library is niaher t-^an that of the svs- 
?ff»r hcinn loaned* the loader Prints: 
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DISC MAY CONTAIN FEATURES MOT SUPPORTEO ON THIS SYSTEM 
(xxx VS vyy) DO YOU TAKE RESPONSIBILITY? 

If the operator answers YES the system uodate proceeds any- 
way* retaining the h i aher level code. If he answers NO the 
message LOAD/DUMP ABORTED is Printed and loading terminates. 
Any other answer will cause repetition of the message; 

00 YOU TAKE RESPONSIHILITY? 

9. Patch Date Codes. 

In an effort to Keeo the system software and I0P software 
compatible? a scheme using date cooes has been implemented. 
The initial IB software has a date code of lt>24 for both 
the system ana the IOP. Each time either processor software 
is updated the date code of both processors will be updated. 
Hence* both processors* should always have the same date 
code. 

Each time the system is brou-jhl up* the dates codes are 
compared. If unequal the following message is printed. 

IOP MAY CONTAIN FEATURES NOT SUPPORTED ON THIS SYSTEM 
(XXX VS YYY) DO YOU TAKE RESPONS IBLI TY? 

^oce xxx is the Patch date code of the system and yyy is the 
patch date code of tne lnP» 

If the operator answers not the load is aborted (must reload 
InP* load aborted) , 

10. Selective LOAD/DUMP/PESTORL 

Selective L0AU*DUMP, and RESTORE share most of the code with 
o^ch other as well as with mag tape reload and mag tape dump 

It starts in the subroutine RLDC with the guestion "LOAD OR 
DUMP COMMANDS"* processes the command* goes to mag tape 
reload section for load or RESTORE ana mag taoe dump section 
for DUMP. when it finishes loading or dumping* it comes 
hack to RLDC ana asks again "LOAD OR DUMP COMMANDS?". This 
cvcle repeats until tne response is "NO" or a carriage 
return and then it exists from RLDC. LDFLG is set to non-0 
for LOAD or RESTORE and for DUMP. 

LOAD all or DUMP a I I 
selective LOAD or 
mag taoe reload 
selective RESTORE 
for RESTORE ALL 
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LFLO = H 


for 


= 1 


for 


= 


for 


=-1 


for 


=-2 


for 



*oro 10 of each airectorv entry is usea as the "recovery" 

f lr»n for that <?ntry. rhe following values of the ••recovery" . 

f I ao ? rp meaningful. 

-1 -"must oe recovered" dur i na LOAD or RESTORE if the 
entry previously did not exist in tne directory. 
1 -"Tujst oe dumoed" our mo [)U*"iP« "should oe recovered" 
during ktSTOKE (i.e. the or cor am/f i I e already exists 
in tne o i r ^ctor y ) . 



Thfl s f- 

b. 
c. 

n. 



f . 



oupnef of events for L0mD/wFST0*E is: 
Clear ••reccvorv" f I aa for all nirectory entries. 
Clear "cons tr uc t en 10" table. 

Ask tne operator for ^ list of <1.;> o»" <ir;>« 
<F'ILh N"K.l> entries. 

If an < iu> is enteren» it is Placed into tne table — 
cell it "constructor) ID table". 

If < 1 1.»>» <namf> is entered: sot the directory entry's 
r ecover y 4 I ca. 
p e w i n a tne m a ci tare. 

pp*n trio I aoe I on loflr t^D? ana cn«cK for va I id feature 
Ipvel coce . 



h. Skip o-ast 'tne first r Of mar*. 

i. Re- r: in first recoro* *hir^ neoins witn tne Directory 
entr y f or t n^»t f i I e . 

j. If t *■» e entry is not in t n p directory jo to step b • 

Otr»prMSfe» Ch<?CK tht- "recovery" flac: if not set« ao 
t o s r eo n. 

k. if thr set •• v r -."hj I c r«> rf j covoreri" f I ••■• '3 is set return 
soar eta tne uof. 

I. near in ^Lfs from fisc onp at r> ti'^e to find the disc 
soace for tn? * i I c ^itnout ro^c/ina soace from the 
ADT yet. 

r. update tne airpctcry entry for mis file with the 
"must re reenvrr^r*' f I ao cleared. 

n. Hff?r*n a reccrn at a time from mao tape ana write to disc 
until t ne I- (..> - =)r * . 

o. w r i tp uPootea airpctory trac« to nisc. 

p. Poan in *U~l a:iair. ano cal I KSOAl- to r»n->ove soace from 

. Al)7. 
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fc. 


Same 


as 


step 


r> 


c. 


Samo 


as 


step 


C 


0. 


Sane 


as 


step 


Cl 


e. 


Sane 


as 


step 


e 


f . 


Sane 


as 


s tep 


f 



a. If there are more files to load* go to step i, other- 
wise, rewina and stand by, 

r. Reaa in one id track at a tine. For each ID* read in 

one directory track at a tine and compute the total 

disc space ussa by that ID ana update the IDT. Enter 
PLDC aqain, 

s. If tne ID is in the "cons tructea ID taole"* out the 
file into the directory and go to step i; otherwise 
to step n. 



Thr> seauence of events for DUMP is: 

a. Sane as step a for LOAD/PHSTOrtE 

for LOAQ/tvfcSTOPE 

for LOAtVtfFSTOPE 

for LOAD/PESTONt 

for LOAD/RESTORE 

for l.OAO/PESTOPE 

g. Reauest "verify" oDtion.. 

h. Set uc tape I aoe I and write to nag taoe, 

i . write £0i- marK, 

j. keao in one directory track at a tine. For each 
entry, check the ••recover" flag: if set, read the 
file fron aisc one record at a tine and write to 
taoe. Tne first recora is oreceoeo by the directory 
entry: the last record is followea by an EOF nark. 
If not set, check the "constructed ID table": if the 
ID is in the table* auno the file to naq taPe, 

k, when all the directory tracks are gone through* write 
an extra EOf marK* a final tape lane I and EOF nark # 
Pewing tne taoe, 

I. Check verify fiao, if not wanted qo to step d. 

m . verify tcpe lanpl and EOF nark, 

n. Peed in one directory track at a tine. For each entry, 
check tne "recovery" f I ao : if set* read the file one 
recora at a time fron disc into buffer at 320U0B and 
reaa from taoe into ouffer at SciOOOd. Verify the 
contents of these two buffers *ith each other. If the 
flag is not set, check the "constructed ID table" and 
do tne sane verification if the ID is in the table. 
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o. verify tr>t- toF* trailer end EOF m^rn. 

d. PewiP;-! the stano hv. 
a. Print "OoNt". 
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This section contains brief descriptions of some routines in 
loader* arranged in alphabetical order. 



the 



BUMP This short routine bumos the pointer to next AOT track in 
the ADT buffer when all ADT tracks are core resident. 
It is called by CLAIM for setting up pointers to search 
next AOT track. (See Paragraph on CLAIM). 

COB This routine is called by SYSLB to claim disc space for 
the system library and swap tracKs. It calls FSDAO to 
find space for library which can be allocated anywhere on 
any disc. It calls CLMSW for claiming swap areas because 
they either start on physical cylinder boundary or do not 
cross Physical cyclinder boundaries. 



CFFw 



CKFC 



CfFw converts the first 4 words of a directory entry (10 
and NAME) into printable ASCII format in a specified 
buffer. 

CKFC checKS for valid feature or patch date code. The 
feature cooe on tape or uisc is considered invalid if it 
is greater than the feature code of the system. The loP 
patch date coae is considered invalid if it is greater 
than the patch date code of the loader. In these cases* 
the user may choose whether to take responsibilities or 
not; if not, then CKFC exists through P+2; otherwise exit 
to P+3. 



CLAIM This routine finds a piece of disc space from ADT* which 
either starts on physical cylinder boundary or does not 
cross Physical cylinder boundary* thus taking care of 
minimizing the interrupts resulting from switching of 
Physical cylinders on both 7900 pise and H&Q3 disc. 

The ADTs used by this routine may be either all in core 
buffer of 14000(H) words long or on disc to pe read in 
one at a time. The subroutine which uodates the ADTs and 
pointers is either BUMP or NUAOT. The entry point of the 
appropriate subroutine is passed to Claim In the word 
CLMFL and CLaIm calls it indirectly through CLMFL • 

CLMSW CLMSW claims swap areas of 40 blocks each and saves the 
disc addresses in the table TPKTb which is written to 
disc. Before entering the DATE-TIME sequence* the loader 
uses TKKTB to -initialize the swap areas and TTY table. 

DACV It converts a positive number of b digits from decimal to 
ASCII and puts into a J-word buffer* right justified with 
leading zeros set to null characters. 

DISC<£ This routine provides the necessary environment for the 
moving head disc driver and transfers i nout/output/seek 
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reauests to the actual driver. 

in conjunction with the GMQbD rout i ne < 01 SCZ Provides a 
buffer for aisc driver generated error messages and 
prints any such errors that occur. 

When certain disc errors occur* DISCZ cnect<s the disc 
error f i ag DStuZ. If it is zero* it halts* otherwise it 
gives control to the callino place through exit to P+2. 
DSLkF is always cleared before DISCZ exits,. 

D^EN The DkEN routine is usea to insert a 12 word directory 
entry into the directory. If the proper directory 
track is full, SUPDP is called to redistribute the dir. 
tracks. bee the system documentation for suoersave for 
a description of its operation. 

EOTCH This routine checKs for an end-of-tape (during Mag Tape 
Sleep operations). it is called when end of tape is not 
allowable (before first file mark). An end of tape 
prints a tape too snort message ana halts. Pressing run 
restarts the aump. 

FNZSC l-NZSC fings the next active disc |*itn non-zero select 
code) ang returns with certain pointers set. 

F'SOao l-SDAO looks for disc space from the ADT, If insufficient 
room in ADT* it returns to p+l; otherwise it returns to 
P+2 with AUTtN set to point to the ADT entry and A-b 
registers set to the aisc address. Disc space is not 
removed from adt if DCfLu is -1 ana is removed otherwise. 

GMObD This routine Provides a Placet-ox for the disc driver when 
it asks for an error message buffer. t"itner this routine 
or DISCZ will print out the message. 

1SADT This routine inserts an entry into ADT and updates the 
ADT length should be in core buffer ang certain points 
and parameters set. 

1SADT This routine inserts an entry into ADT and updates the 
ATD length word in the EOT. on entry, the appropriate 
ADT should be in core buffer and certain pointers and 
parameters set, 

LD101 This routine Performs the following functions: 

A. weaos boCK into core the four system segments that 
were overlayed by the ADT and IDT buffers. 

b. Checks the lOP's aate code in all cases except mag 
tape reloaa. If a mag taoe reloaa is in progress* 
the IoP»s date was checked previously. 
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C. Initialize the random number seed. 

D. write out the swapping Qortion of tne language 
processor for each port. Prior to writing the swap 
track out for a part initialize the pointer to the ? 
ID word that port's teletype table entry. 

E. Save the old device table in a buffer beginning at 
250006. 

F. If upgrading from ACCESS i'A to IB* set the system 
status into EQT to slept and go to step m. 

G. Get the new device table from the I0P« 

h. update the device assignment word for each entry in 
the new device table that nas a corresponding entry 
in the ola device table. Thus maintain old device 
assignments in the new table. 

I. Get the aate from the operator. 

j # Clear the switch register. 

K. Get the time from the operator. 

L. Copy the operators time and status of not slept into 
the EQT. 

M. Save the aisc aactress of the EOT ana the IDEC table 
where the system processor can find them. 

N. write the EQT to disc. 

O. Configure the maa tape driver. 

P. If upgrading from ACCESS 1A to lb halt (MLT 77B) . 

Q. Start the clock ticking every 100 milliseconds. 

R. Print part numoer and date code on the console. 

S. Enable console interrupts. 

T. Enaole Power fail recovery. 

U. Start IOP activity. 

V. Disable kJE command if reguestea. 

w. begin Timesharing. 

LDP30 This routine Checks each disc in the disc portion of EQT 
for a non-zero select code. For each disc found* the 
aisc's label is read and verified (wor a s b and 9 of the 
label which contain the system level and feature level 
codes &re not verified). If any disc does not contain a 
valid label* the operator is given a Change to have the 
disc labeled of TSB. Should the operator decide not to 
have such a disc labeled for TSb it is removed from the 
aisc EQT ana the MHTBL (which is reconfigured to reflect 
the removed aisc). Disc may never be removed. Should 
the operator decide to label a disc in guestion* the bad 
blocks table (block J) is zeroed and the TSB label is 
wr I tten to the d i sc. 

LDR50 This routine, starting at location 320006* builds an AQT 
in core for each active (select code #0) disc. For each 
active disc in the disc EQT* the disc's locked blocks 
table is reaa into a buffer originating at 77300B. The 
AOT is built in core reflecting only the locked blocks 
for this aisc. During the bulla process* the length of 
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a 



the ADT for this entry (in the aisc ADT descriptors part 
of the tuT) is uodate as each entry is added to the ADT. 
When the aDT for a particular disc is completed* the 
starting core address is bumped by 14006 words and 
another active disc is sought. This routine is 
terminated when no more active disc can be located. 

LDP60 This routine claims disc blocks for: 

A. the system 

b. the ID table 

C. the ADT 

D. the directory 

Space is claimed in such a manner that it will not cross 
a cylinder boonory unless the space also oegins on a 
cylinder boundary, Soacea claimed for the system must be 
resident on disc 0. Also the disc addresses of the 
segments of the system are updated in the MST. The other 
spaces neeaea may be claimed from other discs if 
necessary. when the soace for the directory tracks is 
claimed the initial pseudo entries are also written to 
disc. Finally the ADT's which have remained core 
resistent thus far are written to disc. 

LDP75 This routine reads system and system library from mag 
tape ano writes tne overlays to disc. 

EaCh record after being read from mag taoe into a buffer 
at 77300b is Processes as follows: 

A. if end-of-f l I e-wr i te last overlay to disc* rewind the 
rout i ne. 

B. If the record Is origined at location 4002b assume it 
is the Loader-System Linkaae table and go to step D. 

C. ChecK both the startino and ending location of the 
record. If either location corresponds to an area of 
memory that should not contain system code* abort the 
I oao. 

D. ChecK the starting location of the record. If it 
beg'ins at 7500UB It must be a system overlay so call 
SYSLb to write the Preceding overlay to disc. 

E. Perform a checksum check on the record. Abort the 
load if the checksums conflict. Copy tne record from 
the buffer to the appropriate core location. 

F. Process the next record. 

NUADT This routine is called by CLAIM indirectly through CLMFl 
to read a specified AOT into ADT puffer and to set DCAOT 
to point to the beainning of the puffer and clear the 
flag LTMHl for subsequent FSDAD call. 
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RDISL This subroutine is called each time the disc 'EOT' Is or 
might be changed. It sets the interrupt locations for 
all existing aiscs. using the select code and bit 15 of 
each word in the disc EQT » this routine decides what type 
each disc is and reconfigures the MHTbL for discs X thru 
7, AM woras except word d of a disc entry in the MHTBL 
may bt? changed. Also the value of MAXSC (truncated ninth 
entry) which contains a double integer specifying the 
first absolute sector number which does not map onto the 
system disc configuration. 



RDL6L 



RTSwP 



RDLBL calculates the disc address of a specified disc 
label* reads the 32-word label into the disc label buffer 
and checks the checksum for valid label. 



RQINT This routine prints a specified prompt and interprets the 
user's input. An invalid input Prints "ILLEGAL INPUT" 
and asks the Question again, A simple CR or ••no 11 
returns to P+2, otherwise* return to P + l with the 
integer (1 thru 10) In (A). 

RTAOT This routine returns any number of blocks of disc space 
to the AOT on disc. It checks to see which AOT the 
returning space belongs to and reads in the correct 
one. Then i4f^decides whether to insert the new entry 
or to modify the existing entry/entries and updates the 
AL)T to disc and updates the length word of ADT in EQT 
if necessary. 



This routine returns the swap areas to AOT according to 
tne SWAP ARLAb TABLE (SAT) on disc. It reads the table 
into core location lbSOOb and returns 40 blocks for 
every non-zero disc address in the table using RTAOT, 
Then it zero's qut the disc address and writes the table 
back to disc inorder to have the table kept up with the 
current status of AOT, It is called during disc reload 
and system update before claiming disc space for new 
swap areas, 

SLDC This routine Processes the LOAO/DUMP/RESTORE command. It 
only returns to the calling point when no more LOAD/DUMP/ 
RESTORE commands are wanted, otherwise, it taKes the 
input line from the console and processes it. If only an 
10 is enterecu it is placed into a table of ID»s, If 
file names are entered as well* the entry Is Placed into 
the directory with the '•recovery' 1 set. 

SUPOP This routine is used to balance all the directory tracKS* 
with or without inserting a new directory entry as 
specified by the flag SUPTG, 

SYSLR This routine is called by both system generation and 
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system update to write an overlay to'disc. Mag tape 
reload calls SYSLH after loading each overlay. However 
both system generation and system uooate call SYSLB 
prior to loading each overlay* hence the first call in 
this case is always iqnored. If bit 15 of the switch 
register is set* the load halts (HLT 15b) to allow for 
on-line patching prior to writing the overlay to disc (to 
continue simply press •run'*). 

Prior to writing the first overlay to disc* the system 
and level cooes are checKed. Inconsistent feature level 
codes (excluoing system update) allow the user to take 
respons ib i I i ty # 

Additionally, system segments one ana two &re written to 
aisc to allow room from ADT buffers for space claiming 
Purposes. The length of the overlay in blocks is cal- 
culated from the first overlay (liDrary sizes table) and 
space for the overlays and the user swao tracks is 
c I a imed. 

TPLK This routine reaas a mag tape label into the first tape 
label buffer TLWT and makes sure that it has a TSB label 
and a reel number of one. Before reading* it initializes 
the system level and feature codes in the buffer to zeros 
because the TSB tapes Prior to Option 200 did not have 
such cooes ana the taoe levels were 7-words long instead 
of 9. 

WDLTE This routine sets up the disc label* writes the label* 
pre-boot processor ana the intermeoiate and final disc 
. bootstrap onto each of the active. 

WTLRL This routine computes the checKsum of tne disc label and 
writes the entrie laoel sector onto tne specified aisc. 
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EXlEeuaLS 

To attempt to warm start a non-slept system* read the loader Into 
core using the protected disc loader. The lineal disc bootstrap 
will detect that the system has not been slept and the loader 
will print the message "SYSTEM NOT SLEPT; FOR WARM START ATTEMPT* 
LOAD MASTER TAPE AND PRESS RETURN. OTHERWISE MUST RELOAD FROM 
MAG TAPE. Load the Master Tape on the tape drive and select -0 
of the mag tape unit and Press return on the system console. 
The warm start program will be read of* the taoe and will auto- 
matically begin execution* 

The Program starts by printing "**wARM START PROGRAM**". At the 
beginning of each major test* warm start will print the test's 
title. If the test is successful the program will Print "OK"* 
otherwise the reason for failure is printed followed by "WARM 
START FAILURE - ATTEMPT SALVAGE DUMP?". A response Of 
"N-carriage return" or "carriage return" will result in a halt 
77P and the system can then be reloaded from mag tape. A 
"Y-carriage return" response will result in a call to the salvage 
dump routine which will attempt to retrieve all of the files and 
programs listed in the directory and dump them to mag tape. Any 
other response will cause "ILLEGAL INPUT" to be printed followed 
by a repeat of the question "-ATTEMPT SALVAGE DUMP?" 

If the warm start attempt is successful "warm START CHECK 
COMPLETE" is printed at the console. Then the system slept flag 
is set (to sleot of course) and control is returned to the 
intermediate disc bootstrap. Hence the loader is read back into 
memory and the system slept flag is checked again by the final 
disc bootstrap. This time the state of the system on disc is 
"Slept" and the system is nearly up. The ooeator is given the 
opportunity to reply to the prompt "LOAD OR DUMP COMMANDS?" and 
then the date and time sequence is executed bring the system up. 

The following Is a list of the printed test titles and their 
associated diagnostic messages and their meanings: 

I. ADT CHECK- 

A. BAD TnmCK LENGTH - an AOT track length is not a 
multiple of 3 or an ADT track length goes not fall 
within the range bl^<2 to 0. 

B. BAD DISC ADDRESS - the disc address for an ADT track 
i s out of pounds • 
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II. IDT CHECK- 

A. BAD TRACK LtNGTH - an IDT track length as positive or 

not evenly divisible by 12, 

B. TOO MANY ENTRIES ON TRACK - the number of entries 

exceeds t>6d m 

C. BAD DISC ADDRESS - the disc address for an IDT tracK 

is out of bounds 

D. INCONSISTENT ENTRY - the IDE'C table entry's i ocbde is 

not the same as the first i dcode on 
the corresponai ng IDT track. 

E. ENTRY OUT Of- ORDER - an iacode has been found out of 

alphabetical oraer, 

K. BAD IDCODE - an impossible I dcode has been found (i.e. 

an i dcode >79ys») • 

G. BAD DISC SPmCE EnTwy - the amount of disc spaced used 

for en idcode entry exceeds the 
amount a I lowea. 

h. BAD TRACK COUNT - the number of IDT track entries in 

the IDT table does not edual the 

number Indicatea by the Eouipment 
Tab I e'entry . 

Ilia DIRECTORY CMECK- 

a. BAD TRACK LENGTH - a directory track length is positive 

or not evenly divisible by ld» 

B. TOO MANY ENTRIES ()N TRACK - the number of entries 

exceeds tobd. 

C. BAD DISC ADDRESS - the disc address for a directory 

track is out of rounds. 

Dm INCONSISTENT ENTRY - the first 4-word i dCOde-name 

seauence on a directory track is not 
eaual to the traCK's corresponding 
seauence in the DIREC Table. 

E. ENTRY OUT of ORDER - an idcode-name sequence is out of 

alphabetical order, 

f • BAD PROGRAM STARTING ADDRESS - a program entry has a 

start Ina address which does not fall 

within the range from iOOOB to 
dOUUUB. 
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G. BAD PnOGPmm- LENGTH - a Program entry has a length which 

does not fal I within the range from 
-cJ^OOOB to 0. 

h. bAD FILE LENGTH - a file entry has a length which does 

not fall within the range from 
3*767. 

1. bAO PSEuDO ENTRY - the directory entry is not the 

pseudo entry. 

J. bAD TNmCK COUNT - the number of directory tracK entries 

in the DIREC Table dose not eoual 
the number of discs on the system 
times the number of directory 
tracks Per disc, 

IV. OISC SPACE USED CHECK- 

A. INCONSISTENT - the total disc space used summed 

from the Directory Entries. 

If a disc error occurs during the warm Start Program 
testing, the message "DISC ERROR - CORRECT AND RETRY" 
is printed and the computer will halt with 51B 
displayed. 



lttlbKUALS 

warn start functions as follows: 

I. AUT-CHECK 

a. Check the select cooe for each of eight possible discs 
in the core resident ADT Disc Address Table. If the 
select cooe is zero* zero the remaining two words of 
this entry. otherwise* checx the validity of the disc 
address and ensure that the length of the table is both 
a multiple of 3 and between U and -819* words long. 

II. 1UT CHECK 
A. Zero IDWRD 

b. Get next IuEC table entry. 

C. If disc address is zero, go to step Q. 

u. Increment track counter. 

E. Length of track must be neaative. 
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f « Length of track nust oe a multiple of twelve, 

G. TracK may contain no more than bbd entries. 

h. Head in ID trac* from disc* 

1. F irst ID on traCK must equal the corresponding ID in 
the IDLC tabfe. 

Jo ID must oe greater than- IDwRD. 

K. Save ID in lOWND 

L. Numeric Part of ID must be in the range of o to 999. 

m. A I oha Part of id must be in the range of A to Z. 

N. Ada numoer of blocKS used by this ID to a double word 
auan i ty . 

Oi UPdate pointer to next entry. 

P. If there ere more entries on this trac« go to step J. 

u. The track counter must eaual tne number of ID tracks 
(NDIHT). 

III. UlRtCTOHY CMtCK 

A. Set pointer to first entry of DI^EC table, 

H. Zero IDTTC and last entry encountered. 

C. Length of track must be negative. 

Da Length must oe a multiple of twelve. 

k . Number of entries on track can not exceed 6dd. 

¥• kead in airectory from disc. 

G. First four words of track must eciual first four words 
of DlRtC. 

it. If initio! Pseuao entry has not been encountered 
cnecK for it and ac to step k. 

1. This entry must be areater than last entry .encountered. 
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J. MaKe last entry encountered equal to this entry. 

K. If this entry is a file goto step P. 

L. Program started aadress must be between <2000B and 
26000b, 

N>. Program length must be between -d^OOOB words and -3B 
words. 

N. Convert program length to Positive blocks. 

0. Go to step u. 

P. Make sure length of file is positive. 

Q. Add length in blocks to double word quanity. 

k. Advance pointer. 

S. If there are any entries left on this track qo to 
step I. 

T. Set pointer to next DIPfcC entry. 

U. Increment track counter. 

v. If pointer to next OIPEC entry is not beyond the end 
of the table go to step c. 

w. Last entry must be the final Pseuao entry. 

X. Track counter must eoua I the number of discs times the 
number of aiscs times the number of directory tracks 
per disc. 

IV. DISC SPACE USED CHtCK 

A, Tne two aouble word quantities calculated in the IDT 
checK (step N) and the DIRECTORY check (step Q) must 
be euua I . 



System generation 
1. Zero IDEC ana DlwEC tables. 
2» Set system i.aent i f i cat i on to blanks. 
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3. Set number of directory traces per disc. Set NOIRT equal 
to one for 7VU0 loaaers. In al I other cases, set NDIRT 
equal to six, 

<*. Set numaer of ID tracns (NDIRT) eaual to one, 

5, oet system identification from ooerator, 

6, ask operator if conf i qurat i ons ootions ero wanted. 
If so, solicit oisc ana format command, 

7, Check discs for valid labels. (LDW30) 

8, ' Resume conf i yurat i on options. From the operator get the 

f o I I ow i nq : 

A, m I ock ana mun I ock commands 

b. numoer of directory tracks per disc 

C. number of Id tracks 

9, build ADT for each active aisc (LDw^O) 

10, Claim aisc pIocks (LURdd) 

11, Configure cold auric proaram, 

1?, bet the numoer of Ports from the IoP, 

13, Load the system ana the system liarary from mag taoe» 
This includes writing the system liorary to disc, 

14, Rewind ana unload the master tape, 

15, write the system to disc, 

16, Perform the final sequence, (LDlul) 



DISC ktLOAD 

1, Check system level code of disc 0, 

A, If system level code of disc is not eaual to 

the system level code of the loader aoout the load, 

2, Load the final aisc bootstrap using the intermediate 
aisc bootstrap, 

3, Perform the final aisc bootstrap, 

A, Head the loader ana the system from aisc 

h. Need each disc's laoel and verify correct unit 

number, system identification feature level ar\a 

system I eve I . 
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C. Restore confiaurator I i nxage (RDISL) 

D. If system is not «slePt» allow user to attempt 
warm Start 

E. Get number of oorts from IOP. If this number has 
changed* return unneedea tracks ana claim one 
swap track for each port. 

F. Rewind ana unload Master Tape* 

4* Processs Loaa or Dump Commands* 

5* Balance directory tracks* 

6* write DIREC table to aisc. 

7. *.ero Fuss Table ana write to disc. 

a. Perform the final sequence (LDIOI). 



MAG TAPE PELOAD 

I. Check I0P»s oate code (CKfC) 

a* Check system level code of the first reel. It it is not 
the same as that of the loaaer (IB)* abort the mag tape 
reload unless it is a lA system level code in which 
case the system will be upgraded to a lb.. 

3. Read the equipment table from mag tape and update the mag 
tape select coae in the equipment table* 

4. Restore aisc I i nxage (ROISL) 

5. Read the 1DEC table from mag taoe. 

6. keaa the DIREC table from maq tape. 

7. Reaa the device table from maq tape. 
6. Count and save the number of IDs. 

9, Count and save the number of directory entries. 

10. Zero IDEC and UlREC tables. 

II. Zero ADT descriptors. 

ld m Ask operator if configuration options are wanted. If they 
are do the following. 

A. get new system identification from operator 

B. accept disc and format commands. 
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13. ChecK aiscs for valid labels (LDR30) 

14. Resume configuration options. 

From the operator aet the following: 
A. m I ocK ana mun I ock commands 
b« number of directory tracks per disc. 
C. number of ID tracks. 

lb. build ADT for each active disc (LDRbO) 

16. Claim disc blocks (LDP&O) 

17. If configuration options were wanted* esK if the alternate 
allocation option is wanted. 

IB. Distribute the ID entries evenly accross all allocated 
tracks updating lf)£C in the process. 

19. Distribute directory entries evenly accross all allocated 
tracks updating D.IREC In the process. 

A. Set all real (i.e. not oseudo or not nonshareable 

device file) directory entries to "must oe recovered". 

b« uncount each nonreal entry from the number of 
directory entries as counted in step 9. 

20. Configure cola dumo orocram. 

21. Get the number of oor t s from the IOP. 

22% keao the system binary from may table. 

23. Restore disc linage <M)ISL) 

?£.. F«eaa the system library from maa taoe end write all 
over I ays to disc. 

25. write the system to disc. 

26. Recover magnetic taoe horary (mTw) 

27. Process load or dump commands. 

28. balance tne directory tracks. 

29. write DIRtC table to disc. 

30. Zero FUSS table and write it to disc. 

31. Perform final sequence (LDlui) 
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System update 

1* Check the system level code of disc 0, If the system level 
code of disc is not the same as the system level code of 
the loader* abort the update. 

2. Read the Master segment Table from block 1 of disc in a 
buffer. Copy the disc address of each segment from the 
buffer to the appropriate entry in the loader's Master 
Segment Table. 

3. Head the IDEC and DIREC tables from pise. 

4. Read the device table from disc. 

5. Read the equipment taole from disc. 

6. Restore disc linkage (RDISL) 

7. Disallow aisc reload (should the update fall) by setting 
the status of the system on disc to "not slept". 

8. Return space from the system library to the AOT. (RTADT) 

9. Return space from the swap tracks. to the AOT. (RTADT) 

10. Configure cold dump program. 

11. Get the number of ports from the IOP. 

12. Load the system ana the system I ibrary from mag tape. 
This inciudes writmq the system library to disc. (LDR75) 

13. Rewma and unload master tape. 

14. write the system to disc. 

lh. Process load or dump commands. 

16. Balance the directory tracks. 

17. write DIREC table to disc. 

18. *ero FUSS table and write it to aisc. 

19. Perform final sequence (LD101). 
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01SC ORGANIZATION 
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QISC.Oti&dUIZ&ilQtt 

The disc space available to the system Is determined by the 
number and type of discs which exist on the system. The discs 
are aivioed into 25t> *ord blocks. There are 29592 such blocks 
on a 7905 disc* 46fe90 blocks on a 2b83 disc and 97*4. on a 7900 
disc. 

The first 4 blocks of each disc are reserved for use by the 
system. Block is a label* which looks like this: 

wo&O 

1 "TS" 

2 logical disc number 
3-7 system laent i f i cat i o v n 

a system level code 

9 feature level code 

10-30 

31 checKSum of words 0-30 

32-127 pre-ooot processor 

Disc space for system usage is assigned as follows: 

Resident Variable 

IOT 32 blocks/track 

AOT ^d blocks/track 

Directory Jd blocks/track 

System library Variable 

Swap Area 42 blocks/track 

The resident system is always on logical disc 0. in order to 
obtain good disc usage and easy expansion of the system library* 
the disc space occupied by the system library depends on the 
sizes of the horary routines* each of which is either 1 or 2 
blocks long. All the system library routines are contiguous to 
one another on disc. 

All remaining blocks are available for storage of user programs 
and files, programs ano files are each required to be stored as 
contiguous blocks of disc. Since the disc is allocated by 
blocks* each program may cause part of its last block to be 
wasted. when a program is stored- (by the SAVE routine)* it is 
first decompiled and is stored in that form. only the encoded 
text is stored* so that a program may require as little as 3 
words of disc space. when a program is stored (by the CSAVfc 
routine) it is savea in a sem i-comp I I ed form* i.e. the form it is 
in after the symbol table is built. Both the encoded text and 
the symbol table are stored* Plus b words of necessary 
» nf ormat i on. 
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Files always occupy an integral number of records (1-32767) • each 
file occupying a contiguous area on the aisc. BASIC treats the 
individual records in the same logical sequence as the physical 
sequence* 



3-28 



2000 COMPUTER SYSTEM 
DISC FORMAT 



TSb DISC FORMAT 



Block 

B I bck 1 
and 2 

Block 3 



CI a imed 
as space 
ava i I ab I e 
on disc 
in this 
oraer 



i Labe l | 


I Final Disc I 
I bootstrap • 


I Locked block } 
{ Table ; 


{ IDT Tracks } 
| 32 blocks each | 


J ADT Tracks J 
} 32 blocks each j 

{ DIRECTOHY ! 
} Tracks | 
! 32 blocks each \ 


J System j 
{ LIBRARY } 


} Swap ; 
j Tracks } 
J 42 blocks each ! 


1 \ 

{ Us er } 
5 Storage { 



Label Format 










1 


Star t- 


>2 


with 


3 




4 


<-for this 


5 


di sc file 


6 


on 1 y 


7 




ti 




9 




10 



30 
Sof tware->31 
generated 32 

33 



ld7 



••LB" 
'•TS»» 
Logical disc 


# S 


System 
ID 




System level 
Feature 1 eve 



code J 
code; 




Parity check 


word { 


Pre-boot 





3-29 



HP 2883 Disc 

Logical Disc 

BUObeC fciCSl-BlQCB 



1 46690 

2 93360 

3 140070 

4 186760 
b 233450 

6 260140 

7 326830 



HP 2663 



Cy I i nder 
.Quebec. 



Di sc 




F 


irst 


Pe 1 at i ve 


- 


tiiQCtS 








230 

460 

690 

920 

1150 

13b0 

1610 

1«40 

2070 





HP 2683 DISC 


Cy I inder 


First relative 


UuGJbfiC 


QlfiCiS 








10 


2300 


20 


4600 


30 


6900 


40 


9200 


50 


USOO 


60 


13800 


70 


16100 


60 


18400 


90 


20700 


100 


23000 


110 


2SJ00 


120 


27600 


130 


29900 


140 


32200 


lbO 


34500 


160 


36800 


170 


39100 


160 


41400 


190 


43700 


200 


46000 
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HP 2bH3 Disc 



HP 2bb3 Disc 



o 
l 

2 

3 

4 

b 

6 

7 

8 

9 

10 

11 

12 

13 

14 

lb 

lb 

17 

lb 

19 



First 


BSiflSiYfi-QiQCb 







11 


1/2 


23 




34 


1/2 


<*t> 




b7 


1/2 


69 




bu 


1/2 


92 




103 


1/2 


115 




126 


1/2 


13tJ 




149 


1/2 


161 




172 


i/2 


lb4 




19b 


1/2 


207 




2X6 


1/2 



SectQC-CjyQjtsec 

o 
l 

2 
3 

4 

5 
6 

7 
b 

9 
10 

11 

12 
13 
1* 
IS 
16 
17 
lb 
19 
dO 
21 



BiQCb 



1/2 
1 

1 1/2 
2 

2 1/2 
3 

3 1/2 
4 

4 1/2 
5 

5 1/2 
6 

6 1/2 
7 

7 1/2 
8 

b 1/2 

9 

9 1/2 
10 

10 1/2 
U 
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HP 7900 DISC 

Logical Disc 

Bucbec fcicsl-biocfc 

o 

1 9744 

2 19486 

3 £9232 

4 38976 

5 48720 

6 b8464 

7 68206 



HP 7900 DISC 

Cylinder Mrst Relative 
-bufflbec. bJLQCts 



o u 

1 4tt 

2 9b 

3 14* 

4 19ii 

5 2*0 

6 dbn 

7 336 
6 364 
9 432 



HP 7900 Di SC 


Cv[i nder 


First Re 1 at i ve 


bumbec 


BiQCfc 








10 


480 


20 


960 


30 


1440 


40 


1920 


b0 


2400 


60 


2660 


70 


3360 


80 


3840 


90 


<*320 


100 


4800 


110 


5280 


120 


5760 


130 


6240 


140 


6720 


lbO 


7200 


160 


7680 


170 


6160 


lttO 


8640 


190 


9120 


200 


9600 
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HP 7900 Disc 



HP 7900 Disc 



dead.uuQteec 



First 



sectQC-tiurabsc 



QlQCtt 




12 
24 
3b 




1 
2 
3 
4 
5 
6 
7 

a 

9 
10 
11 
12 
13 
14 
lb 
16 
17 
18 
19 
20 
21 
22 
23 



1/2 

1 

1 1/2 
2 

2 1/2 
3 

3 1/2 
4 

4 1/2 
5 

5 1/2 
6 

6 1/2 
7 

7 1/2 
8 

8 1/2 
9 

9 1/2 
10 

10 1/1 
11 

11 1/2 
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HP /*0S DISC 



Logical 


First 


Cy 1 [.nder 


First 


Uisc.biutDbec 


eiccb 


Uumbec 


BfiletiHfi-tilQCtS 














l 


29592(10) 


1 


72 


2 


49io4(10) 


2 


144 


3 


66776 


3 


216 


4 


Ilb3to8(10) 


4 


266 


5 


147960 


b 


360 


6 


1775b2 


6 


432 


7 


207144 


7 


S04 


b 


236736( 10) 


b 


576 






y 


643 






10 


720 


, 




£0 


1440 






30 


2160 






40 


2d80 






bO 


3600 






60 


4320 






70 


b040 






80 


b760 






90 


b460 






100 


7200 






110 


7920 






120 


6640 


Cy 1 i rider 


F irst 


. 1 jo 


9360 


-UutDDfiC- 


bfiiSliy§-biQCB 










140 


10060 






IdO 


10600 






lbO 


11S20 


U 





170 


12240 


1 


72 


160 


12960 


2 


144 


1*0 


13660 


3 


21b 


200 


14400 


4 


2bb 


300 


dlbOO 


b 


360 


^00 


28b00 



432 
504 
b7b 
643 
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HP 7905 Disc Relative block Numbers 

»• irst 



1 24 

2 48 



§ector 


First 


biufflbec 


Bsia£i*e.BiQcfc$ 










i 





1/2 


2 


1 




3 


1 


1/2 


4 


2 




5 


2 


1/2 


6 


3 




7 


3 


1/2 


8 


«► 




9 


4. 


1/2 


10 


5 




11 


b 


1/2 


12 


6 




13 


6 


1/2 


14 


7 




IS 


7 


1/2 


16 


8 




17 


8 


1/2 


18 


9 




19 


9 


1/2 


20 


10 




30 


lb 




40 


20 
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MIGrt OISC 
ADDRESS WORD 



15 



13 id 



« 7 



D 4 



NOT USED J HEAD NUMbERjNOT USED 



} LOW OISC 
SECTOR NUMbERI ADDRESS WORD 



hAKDWAPE 
DISC ADDRESSING 
FORMAT FOR HP d663 
(32 bit Data Channel word) 



(DRIVE SELECT CODE IS 
CONTAINED IN COMMAND WORD* 
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lb 



fl 7 



NOT US£D 



CYLINDER NUMBER 



WORD 1 



15 10 


9 8 


7 S 


<* 


NOT USED 


HEAD NUMfafcR 


NOT USED 


SECTOR NUMBER 



WORD 2 



HARDWARE 
DISC ADDRESSING 
FORMAT FOR HP 7900 
(32 bit Data Channel word) 



(DRIVE SELECT CODE IS 
CONTAINED IN COMMAND WORD) 
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NOT USED 



CYLINDER NUMBER 



WORD 1 



13 Id 



8 7 



HEAD NUMbER} SECTOR NUMBER 



WORD 2 



HARDWARE 
DISC ADDRESSING 
FORMAT FOR MP 7*05 
(32 bit Data Channel word) 



(DRIVE SELECT CODE IS 
CONTAINED IN COMMAND WORD) 
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DISC EPPO* ROUTINES 
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Svstpn error recovery is predicated on three different types of 
failure: 1) inability to raQd or write a portion of the disc 
or x 2) total system failure due to a complete disc failure* 
processor malfunction (especially memory parity errors)* software 
failures* etc; or 3) loP failure. Recovery from disc failures 
entails calling of a routine dependent on the tyoe of entity 
involved (user swap track, directory track* IDT track* ADT track* 
command overlay* etc.). Recovery from a total system failure 
entails use of the warmstart oroaram (detailed in the section of 
this Document concernino the loaoers) in conjunction with some 
Droohylactic measures always taken hv the system, Recovery from 
an Iop failure entci Is t*e use of the IOP PANIC routine, 

Disc-Eailuces 

An unrecoverable aisc *rror while swaDOino a user in or out of 
memory causes a call to the Po^T ZAPPfP routine (PTifAP). Ap 
error in reading sn overlay causes a ca I I to emergency SleeD 
(STCKP) . Inability to read a system track (directory* IDT* ADT* 
etc.) typical lv causes a call to SICKP, occasionally* however, 
the message DISC EkhOK.* CAN»T DO IT is output when the error in 
rea-iino the system tracK is related to a minor command. An error 
in writing a system track causes a call to tne SALVAGE routine 
(SLVAft) • Any non-rccover ao I e read/write failures (e.a.* Dor t 
7flpoor and salvage art> disc resident! a failure in reading tnem 
into memory is a non recoverable read fai lure) causes a call to 
th*=» system death rooutine (UEaOP), The routines oor t zaoper-^ 
salvaof, emercency siceo* and oeadare aiscussed oelow. 



lQl3l-S*SleE_EflilUCS5 

In order to allow recovery from * total svstem failure* the 
tanles on the disc must ne up to date ana consistent. This is 
generally the case with tne exception of the DltffcC and IDFC 
memory resident tables and the eauloment tflole wn i en contains 
news about the system a-0T entries. Therefore* eacn time a 
directory track is shortened or lengthened* an 10 track is 
shortened or lenothened* or a svstem tracK is moved (see salvaae* 
below) the eouipment* the PIREC and the lDfc taoles are uodated 
on disc. This Preventive measure ensures a good chance that all 
disc resident system tables f*re ub-to-aate -ana consistent. The 
warmstart proqram* which would be used in case of total svstem 
fai lure* thus has a good chance of f innina tne disc in good 
shaae. 
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Ioe-Eculucea 

Wnen the IOP fai Is. users are instructed to execute the IoP PANIC 
routine. This routine sends to the SP a ouffer empty notification 
for pflch port. This ensures that the SP noes not hang because of 
a nuffer full bit set in a user's ?FLA6 word. In addition* it 
resoonds to all requests from the SP with a 0. If any user 
reauirea inout* this o fakes a response (all system code which 
receives characters from the IOP treat a as a carriage return 
- a null (ASCII 0) is ne\zor I eoa I as an input character since 
nulls &re stripped by the IOP). This also satisfies any other 
SP requests (e.q.» system sends transfer inout ouffer and IOP 
responds with 0. System interprets this as zero length transfer 
and is satisfied). finally, the IOP is listeninq for send cold 
dumo (KSN) commands so a cold dumo can oe Performed when the IOP 
is in PANIC. 

THp net result of PmnIC is to get the system processor to a point 
where a SLEEP (or HIbERNATE) command can be entered at the system 
console. The constant hFE»s and zero responses from the IOP 
allow the system to be successfully sleot. 



3-41 



Uisd-cccceQutioss 

The deao routine informs all users that the system is going down* 
clears all non-shareable devices (to free the IOP)» tells the Iop 
th*t the system is goina down* informs the console operator of 
impending death, and, finally* halts the system. 

The emergency sleep routine does the same thing as DEAD with two 
excot i ons : memory resident tables ar'e uPdatea on the disc and 
the system slept flag is set to sleDt. Recovery is guaranteed 
from an emergency sleep. 

Hoth jettison port (PTZAP) and salvaae reside on the disc. They 
are rear) into the area r>etween the user arecs and the disc driver. 
If a failure occurs when reading, we call 06.AD. 

Jettison port kjcks a user off the system* maK i ng his port 
unavailable for further use. It first removes the user from the 
scheduler aueue ana clears main in case it was set. The user's 
?FL^G woro is clearea and non-shar eaDl e devices are released. 
The user's area of the FUSS table is cleared to release any files 
he micht have been using. Finally* we inform the user of the 
loss of his Port, set the port's status to unavailable* tell the 
system operator of the error* and return to normal system 
operation minus one port. 

Salvaae is callea on a failed write of a system table. It 
assumes that the tracK is in memory start ina at LIbUS and that 
woph contains the length -of the track. it also assumes that 
STnap contains the aisc address where the trac* has failed to 
have been written. in the worst case an entire track (dl9<£ 
words) ano a table (such as the one createo by the system 
operator's PUR<J£ or mlqCK commands) is in memory. we are always 
ouaranteed that the space occuDied aops not extena past d*+OQOd. 
Fxecution is *s follows: 

1. Reao approximately Ik (7hh words (3 ooes not divide evenly 
into IK)) chunks of the ADT into d+OQQt, (tnrow away the AOT 
if we can't reed it) and search for a free area large enouan 
to nolo the tracK. if no space is found and track to oe 
salvaged was an mdT* throw it away ano exit. otherwise we 
must die because we can't move the tracK. 

2. If space is founo* substitute the new disc address in the 
memory resident table that Points to the respective track. 

3. write track to its new location on the msc (if we can't* we 
die- goto DEaTh) . 



3-42 



4. Penove the space froii the aot for the new area just claimed, 
tell the operator that a track was moved, and return to 
normal Process ing. 
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COLD DUMP PROGRAM 



Preparation for running the cold dumo croaram 

1, If the I/O processor is halted* note the register values 
and start It at ••Panic" (location 2000R .). 

2. Halt the main" processor and record the value of the 
p-regi ster . 

3.. Mount a mag tape with a write r i no and select unit 0, 

4. Set the P-register to 77000b (the starting location of 
the memory resident bootstrap that reads 'the cold dump 
program from disc. 

The cold dump bootstrap Performs the following functions 
sequent I al I y • 

1. turn off the interrupt system 

2. save A»o* E. and registers 

3. disable power fail recovery 

4. read the final disc bootstrap in memory starting at 
location 40000H. 

5. act the disc address and size of the Cold Dump Program 
from the Master segment Table portion of the final disc 
bootstrap. 

6. read the Colo Dump Program into memory starting at 
locat ion 40000rt. 

7. jump to the Cold Dump Proaram. 

The cold dump program is assembled at location <!400QB 
hut is read into memory at location DSCDA (currently 
location 40000b). 

The cold dump program performs the following tasks 
seauent I a I I y : 



wr i te r i ng* 



0) . 



1. Checks that unit Is on line. 
«?. Checks that the mag tape has a 

3. Rewinds tape. 

4. writes cold dump label. 

5. writes register values (a»b«E ana 
b. writes system processor memory. 

7. Heads the final disc bootstrap leads into memory at 
location 32000B. The MST portion is needed as It 
contains the disc addresses of the disc resident 
portion of the system. The initial time the final 
aisc bootstrap was read into memory* it was overlayed 
by the cold dump Proaram after the disc address and 
length of the cold dump proaram was extracted. This 
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minimizes the amount of memory that gets clobbered or I or 

to being dumped to maa tdPe* 
6. If Possible (if the IOR Is •• li s ten i na») 9 the IOP memory 

is dumped in chunxs into a 1^7 word system orocessor 

buffer. After each transfer is completed* the buffer Is 

aumped to mag taoe. 
y. fieao system disc driver into memory* 
lu. Restore disc driver: 

A, Clear fobUSY 

H, Suppress disc error messages 

C. Restore Pointer to the mhtBL 

D. Restore aisc driver interrupt ooints 

E. Set interruot locations for all discs. 
11 • Dump swao tracks: 

A. read sys tern- I oader linkage table from disc, on 

failure* foroet about dumping swap tracKS. 
H. From the I irmaat ar^a nmt the maximum length of 
a user swap track* starting core address of user 
. swap area* length of a TTY table* and the pointer 
to the aisc address of the swap track for port 0. 
C. Dumo all swap tracks* stooing after 3<Z have been 
dumped or a disc address of zero is encountered. 
1?. Dumo I iorary sizes table and FUSS table. 
13. Dump directory tracks stooping after *0 tracks have been 

dumped or a aisc t aadress of zero is encountered. 
14.. Dump ID Table, stoooino after 10 tracks have been dumped 

or a disc adaress of zero Is encountered. 
IS. Dump Available Disc Table* stooping after 8 tracks have 

been dumpea or a disc address of zero is encountered. 
lh. Terminate Colo Dump: 

A. write 6 eng-of-file marks 

d. Issue a remind/standby to mag taoe unit 0, 

C. Halt 7 7b 

The following errors are correctable by correcting the 
problem and then oressina tf<uN». Other errors are not 
recover ab I e. 

Errors 

HLT 22H - DISC NOT READY 

HLT 338 - NO WHITE. RING ON mag TAPE 

HLT ^4R - MAb TAPt UNIT IS NOT ON-LINE 

HLT S5B - MAO TAPE had OR TOO SHORT 



COLD DUMR TAPE FORMAT 



The cold dump taoe is written in variaole length records with 
a maximum record length of 1^7/10 words. The. tape is written 

3-45 



in the following format. 









CO 


Laoel 






LD 




A 




DU 


Rea i sters 


b 




MP 




EXXXXO 


(Extend/ 


hOOO 


Sys ten 




Ovf 1 ) 




Processor 


loc ? 






Memor v 


loc 3 






I/O 


loc 77777 






Prqcessor 








Menor y 


loc 






EOF 


loc 1 






Swao 


• 
• 






TracKs 


• 







10 



SwfiD 


nFM>FP 


1st 4 


TraCK 


OATA 


Words 







of TTY 
Table 


EOF 






Swao 






Track l 






EOF 







EOF 



SwdD 

TraCK 31 

EOF 

EOF 
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COLD DUMP TAPE FORMAT (cont.) 



L i nrary 
S i 7.t?s 
T^ble 

K 
FUSS 
Tab I e 

EOF 

f) i rectory 
Tracks 



• 
• 


• i 


• 


• i 


{Library ; 


{Sizes 


table* ; 


J (256 


word*?) ; 


J FUSS 


t cib 1 e { 


i (10*4 


words ) { 


J EOF 





5 D ir ector v 
{ track 1 




!EOF ; 


• • 

• • 




{Directory { 
StracK mo • 


{EOF { 


! EOF 





{HEADER! 
{DATA { 



5DIREC Entry 0{ 



{FOF 



10 
10 
Tr <-)cks 



! ID 
{ track 


i ; 


,'EOF { 


i • > 


! ID 

{ tracK 


lo 


! b OF { 


!£0F 





{header; 

} DATA { 



! I DEC Entry u { 



! FOF 
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COLD DUMP TAPt FORMAT (cont.) 



f» 

ADT 
Tracks 



ADT 
track o 



EOF 



ADT 
track 7 

EOF 



! HEADER! 
J DATA J 



JAOTAT Entry 0} 



{EOF 
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MAGNETIC TAPE FORMATS 
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2000 COMPUTE* SYSTEM 
SLEEP AND HlBfcPNATE 
TAPE FOPMATS 



LAbEL 



EQUIPMENT 
TAbLE 



DIPEC 
TAHLt 



ID TABLE 
DIPECTOPY 



DIPtCTORY 



DIPECTOPY 



SYSTEM 

SEGMENT 

TAttLE 



SEUMENT 1< 

INTEPPUPT 

TAHLE 



SEGMENT 2- 
HASE PAGE 



SEGMENT 3- 
SYSTEM LINKAGE 
TAdLE 



SEGMENT *- 
SYSTEM SEGMENT 
1 



first word of first record only 
is the recora word count 
(negative) Placed there by 
the Maq Tape driver 

Format the same as dump TAPE 
format 



Lines indicate kecorg Mark 



Dumped in 102M10) word records* 
up to bu(iu) records 

Dumped in 102M1U) word records* 
up to 6*0(10) records 



Last Directory record is <= 2000(b) 
woros and >= 12 words 

From loader MLTbL to Mi_TdE — 
defines segments yet to be 
oumped 



Core locations 2 to 2/(8) 



Core locations from end of 
Equipment Table to 1777(b) 

Core locations containing loader 
system linkage jnfo-2U02(b) to 
201b(tt) 



core locations from end of DIPEC 
Table to *»1777(«) 



(Continued on Page 2) 
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2000 COMPUTED SYSTEM 
SLEEP AND HIBERNATE 
TAPE FORMATS 
(Page" 2) 



SEGMENT 5- 
SYSTEM 
SEGMENT 2 



SEGMENT 6- 
SYSTEM 
SEGMENT 3 



SEGMENT 7- 
SYSTEM 
SEGMENT 4 



SEGMENT 8- 
SYSTEM 
SEGMENT 5 



LIbKAPY 

LENGTH 

TABLE 



(all of I ibrary 

one per record) 



EOF 



Core locations 4-2000(8) to bl777(8) 



Core locations 52000(d) to 6W77(8) 



Core locations 62000(8) to 71777(8) 



Core locations 72000(8) to 77677(8) 



Tape must be long enough to 
record at least to here* plus 
an end of tape marker 



If tape Is long enough* user 
program and files will be 
recorded here in same format as 
on DUMP TAPE - HIBERNATE records 
aM files and programs. SLEEP 
records all programs and files 
that are neW since last 
HlbEPNATE 
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2000/COMPuTER SYSTEM 
DUMP TAPE 
FONMAT EXAMPLE 1 



words 

allocated 



Tape 1 



woro counts-lo 



LAtiEL 




12 



256 }"F He 1* Logical 
Block 1 



256 



256 



256 



256 



t 

File It- Logical I 
block 2 

File 1, Logical 
block 3 

File 1* Logical 
block 4 



File I* Logical 
block 5 



EOF 



12 {Directory Entry 

256 {File 2, Logical 
block l 

EOF 

EOF 



Negative word count of record 
Decodes as: 







word 1 


!"Lb M ! 


d 


{"TS" ! 


3 


{not useo } 


4 


tree! numoer (oegin; 




} with 1) : 


5 


! year } 


6 


{hour of year . ; 


7 


•tenths of seconds i 




j -36000 J 


b 


{system level code { 


9 


{feature level code] 



Identical to DIkECTowy format 
described elsewhere 

Dotted lines denote logical 
information divisions 

Solid lines denote record 
(EOR) gaps 

Last Physical dIock of a b 
blocK FILE 
End-of-f lie 



I block file 
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fcnd-Qf-taPe» out not end of 
entire dump 
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2000/COMPUTtP SYSTfcM 

DUMH TAPt 

FORMAT tXAMPLt 2 

woras 
ailocslfid 

Tape 2 

word count 



12 



1024 



M 



12 
256 

256 



12 

L 



LAbtL 



Directory Entry 



Program A 



Program A 
itOI- 



Directory tntry 

File 3* Logical 
block 1 



F i le3»Logica I 
block 2 



tOF 



<— Programs are dumped to exact 
length - length aerived 
from DIRECTORY 12 < M < 1024 
woras • 



> 
> 
> <- 

> 
> 



- 2-b I ock file 



1 
i 

Directory tntry I 
•••••••••••••••• 

program b ! 



<-— L< 102** words 



ItOF 



! > 
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1 {wore count 



LAbtL 



{EOF 



J > 
,{ > 
i > 
I > 
! > 
— > 
5 > 



< — Ena-of-taPe 
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2000/COMPUTfc.H SYSTth 

DUMP TAPE. 

FORMAT EXAMPLE 3 



TAPE 3 



! word count { 


I Label ! 


! EOF ! 


} Directory Entry { 


} Program C 5 


! EOF { 


J EOF { 


S EOF J 


5 word count ! 


! LAHLL J 


t EOF } 



ANOTHEP POSSIBLE 
FOPM OF TAPE 3 



Woro count 



Label 



! EOF 

5 EOF 

! EOF 

I word count 

! LABEL 

! EOF 



<-Eno of the 

> set of DUMP a 

> tapes Indicator Less common termination— 

> lest tape is used to 

> <-tna-of-taPe contain only the "eno 

> of the set of DUMP tapes" 

> indicator 
> 

> 
> 



A 

Normal 

I ast entr ies 
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20Q0/COMPUTER SYSTEM 
DUMP TAPE 
FORMAT EXAMPLE 4 



TAPE N 
word count 



LABEL 



Directory Entry 

File 4, Logica I 
B lock 1 



File 4* Logical 

biock a 



File 4» Logical 
Block 3 



File 4, Logical 

Block 4 

EOF 

word count 

LABEL 

EOF 



> 
> 
> 

> <-End of tape 

> 

> 



TAPE N +1 



J word count 
!...... 



J 

J LABEL 
I 



t 



t F i le 4, Logical 

I Block 5 

i 

{ File 4 « Logi cal 

t Block 6 

j -_- 

i F i I e 4f Log ical 
5 Block 7 

1 EOF 
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SCHEDULING 
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SCHEDULING 



The basic chilosDhy of the TSH scheciul tnq a I aor i 
short response times for short* interactive joos 
coit of delays in longer running jobs. The i mo I 
this involves a queue of jobs to run which is or 
to a oiority scheme. The au'eue Is a linked list 
entries* each entry pomtinq to the next entry, 
entry pointing back to the first. The 34 possigl 
aueue ©re the 32 user LINK entries* a LINK word 
TELETYPE table reserved for the svstem console. 
The aueue head consists of the locations mLInk ( 
alwavs in the aueue. The aueue heaa has a Drior 
*hich is stored in location, mlInk + £« and it is a 
entry In the aueue. As an example of ho* this w 
us^rs 1« 3 and 6 are on the aueue In tnat order 
svstem console, in a Position between users 3 an 
gu^ue will have the following appearance: 



thin is to provide 

at the poss iole 
ementat i on of 
dered according 

of from 1 to 34 
ang the last 
e entries in the 
in a truncated 
and a aueue head. 
0:2) « and i s 
i ty of 7 mi (h) , 
I ways the I as t 
or«s« assume that 
and so is the 
d b. Then tne 



TT Yl»l+?LINK 
?PLKV 

TTY03+?LINK 
?PLEV 

1 li^LK 
T3tHk 

TTY0er + ?LlNK 
7MLFV 

MLINK 















7 777 7 
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Sine? the ml INK entry is always the last entry on the Queue* 
MLT^K+l is a pointer to the first entry* which in this case is 
TTyOI. In the case of an emotv queue* ML INK + 1 will point to 
itself* i.e.* CONTENTS (MLINK+1 ) = CONTENTS (MLINK ) . Each entry on 
the Queue has a priority no less in numerical value than that of 
the one its Points to. When an entry is to be added to the 
Queue* it is assignee a priority according to the rules described 
below* and then INSEQ is called, INSEQ computes a new priority 
using the following formula: 

New priority = -(old pr i or i ty) * (number of Ports logged on + l)/4 

The aueue ordering is preserved by inserting the new entry just 
ahead of the first entry with a lower (more negative) priority 
number. Note that when the first entry in the queue has priority 
0* it will maintain that position until it is removed from the 
queue entirely. To ensure that all jobs will eventually reach 
the top of the queue* the priority of the entry just behind the 
new entry is incremented ny one. Note that by using the number 
of ports logoed on the system as a factor in determining 
priority* we base the speed at which jobs reach the top of the 
queue on the system load. 

The following rules are used to assign (ana reassign) priorities 
by routines which call INSFO: 

1. noon first enterina the oueue* jobs ere assigned Priorities 
as foil ows : 

SYNTAX lines ana jobs returning from I/O susoend: 
*ASIC commands (&UN* LIST* PUNCH* LOAD) : 1 

Commands for ai sc-res i dent routines (GET* 3YE* Etc.): d 

?, Priorities of Jobs are reassigned in the following way: 

jobs of priority 'd% when they reach the too of the oueue* are 
reassigned Priority 0, 

RUN jobs* when they exceed their time slice* are reassigned 
priority 4* ana repositioned in the aueue accordina to that 
priority. Each run job is assigned a time slice of two 
seconds* and if it exhausts that it* is assigned another, 
When executing a <CHAIN statements a <SYSTEM statements a 
<CKfcATE statements a <L0CK statements an <UNL0CK 
statements a <FILES statements or an <ASSIGN statements 
a RUN job is reassjoned a priority of 0, 



The CPEATf- command is reassianed a priority of 4 when it is 
susoonaea after writ ma file marKS in 400 bloc*s. 

After an abort during oroaram execution a user is re— assigned a 
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priority of to run the routine which updates the last chanae 
date for files, 

LIh Doints to the locaion in the ComTABLE of the disc address of 
the library routine in core. LIH = when none is present. 

The followinq conditions must exist for the scheduler to permit 
execut ion: 

A) for Syntax ana BASIC commands; 

MAIN set td point to correct user table 

«) for disc resident commands: 
►*AIN = 
LIP set to correct oisc resident routine 

The scheduler routine swapr is responsible for creatine these 
conditions* and makes its decisions accordinq to the values of 
main* Lib* and tne entry on too of the queue. 
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SCHEDULER 



f CLOCK INTERRUPT] 



UPDATE THE 
TIME OF THE 
HOUR. 




ODD 



YES 



-* 



SAVE REGISTERS 
ANO BLOCK THE 
CLOCK. 



-3L 



CLF CLOCK 



I 



X 



CLF CLOCK 



(ZED 






PRIORITY -M 
REMOVE FROM 
QUEUE. 




FLOWCHART 

1 of 13 



SCHEDULER 




INSERT THE USER 
ON THE QUEUE 
BY PRIORITY. 



ADVANCE 
POINTER TO 
NEXT TTY. 




YES 




"WSCHS1 




-WSCHIJ 



JUMP TABLE CALL 
BASED ON USER'S 
CURRENT STATUS. 



FLOWCHART 
2 of 13 



SCHEDULER 



CsNsrfcocf 
a hit u?s>*re 




SET POINTER 
BACK TO FIRST 
TTY TABLE 




UPDATE COUNT 
AND MESSAGE 
BUFFER POINTER, 




YES 



■WsCH15l 



YES 



rSCM15l 



-WsCH16J 



NO 




UPDATE COUNT 
AND 3UJLO 
LOG MESSAGE. 



I 



Construct 



TTY3S 



OUTPUT A 

MESSAGE. 




FLOWCHART 



SCHEDULER 




[SClfc 




7 



Nt, 



Receive Messrs, 




Yffi 



SliKb 
TO 

ire p 




*»CtO 



FLOWCHART 
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SCHEDULER 




SET POINTERS 
FOR QUEUE 
INSERTION. 





PMhT 



' ' iT -?■ rr 



^Ttr C^O 




F\.OWCH?R r 



SCHEDULER 




LIBRARY TYPE 
PROGRAMS MUST 
RUN TO END 
BEFORE BEING 
SWAPPED OUT. 



ONLY BASIC 
PROGRAM 
EXECUTION IS 
TIMED. 



s. ?RSTR - 0? ^ 




PREG-*?RSTR 




7RSTR -♦■» 










1 


f 








SET THE TIMER. 





SETTIMEFIF 
THIS IS RUN, 



RESTORE 
REGISTERS. 



I 



RESTORE DISC 
BUSY FLAGS. 



ENABLE INTER- 
RUPT AND EXIT 
VIAPREG. 



FLOWCHART 



SCHEDULER 



¥~- 



AN INPUT HAS 
BEEN TYPED OR 
AN OUTPUT HAS 
ALMOST 
COMPLETED. 



RESTORE THE 
ACTUAL STATUS 
(SAVED IN 
?PLEV). 



SETPLEV+-0 



ADJUST POINTER 
FOR TTY TABLE. 




§1" 



REMOVE USER 
FROM QUEUE. 



CODE TO 
HANDLE ABORT. 



HEMOVE OUTPUT 
WAIT A^D CHAIN 

Sirs FHw ?fcag 



i 



KILL OUTPUT. 



fsCHSJ* 



SET UP FOR 
RUNNING CORE 
RESIDENT ABUCD 
ROUTINE. 



T 






(son*) 






KSmo^S USSR, 



Kiu, cu7s F»li= 
IP pftiTtiteA/T 



Scratch Pfcc^AA 




FLOWCHART 



SCHEDULER 




i 

CODE FOR 
FORCED D1S- 
CONNECT 
(USER HUNG UP). 



REMOVE USER 
FROM QUEUE. 



CLEAR ABORT 
FLAGS. 




SKIP RESTART 
MEANS ENTER 
TJMEO OUT. 




AN ENTER 
STATEMENT HAS 
TIMED OUT. 



FLOWCHART 

Q rvF 1 "5 



SCHEDULER 



A LINE HAS BEEN 
ENTERED FOR AN 
IDLE USER. 




PRINT "PLEASE 
LOG IN" 



SET ?RSTR FOR 
SYNTAX. 



STATUS-*" 
SYNTAX SET B 
FOR INSEQ. 





TELL COM- 
MUNICATIONS 
PROCESSOR THAT 
ANOTHER LINE 

is allowable: 




FLOWCHART 



SCHEDULER 



COME HERE 
WHEN A VALID 
COMMAND HAS 
BEEN FOUND. 




WINT TUEASE 
LOGIN" 



CLE" h £> 
TAPS ^obE 

FLAG- 






CHAMOCCOM- ■ 
MAND TO "TAPE 
E««OR PWSENT' 



CLEAR TAPE 
ERROR FLAG. 




PRtfiT-IHJN 
OWLY" 



© 



FLOWCHART 
10 of 13 



SCHEDULER 




(SCH1? 



SET PROGRAM 
STATUS. 





Sw " 








III 




, 1 


' 




V 


SET STARTING 
ADDRESS IN 
LIBUS. 




SET STARTING 
ADDRESS. 


V _ V 


?PLEV"*-2 




?PLEV«"1 


i 


" 






SETB«-?LINK 






FOR IN 


SEQ. 










FLf^-W^H -.FT 



SCHEDULER 




WRITE OUT PRO- 
GRAM IN CO*I. 
MAIN ~*0 



— WSCHlJ 



FLOWCHART 
12 of 13 



f ReTU^ j 



SCHEDULER 




[swap; 



S^ INITIATING ^s>. 



ANO 
SETLCHCR FLAG 



SMAIN+--1 

INITIATE 

READING 

LIBRARY 

PROGRAM. 



I 



SCH 




NO 



^«w ROUTINE ^r 




YES 



YES /* "N 

* W RETURN J 




SET MAIN - 0. 



± 



INITIATE CORE 
TO DISC 
TRANSFER. 



T 




SCH1 



FLOWCHART 



COMMUNICATION bETWFEN SYSTEM MODULtiS 
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COSftWBlCfillQbl-eEItotEU-SXSieM- MODULES 

Therp are six system modules that communicate with each other in 
various ways: tne oisc driver* I/n Processor driver, system 
console or i ver • scheduler* BASIC* and system library routines 
(HELLO* eYE* KILLIU, etc.). 

I-..QISC-DBIV.E* 

An v section of tne systen may call tne disc driver to perform a 
(mov i na-read) aisc transfer. Throe parameters are passed to the 
ar i ver : 



a = pointer to aisc address 



(the core address of a two word 
I on i ca I aisc b I ock numoer et 
which tne transfer is to begin) 



H = core aaoress 



(bits 14-u - core address at 
which transfer is to oeoin; bit 
Jb s i for read from disc to 
core; vits lb = for write from 
core to disc) 



The variable mwo^U = the neaative of the number of words to oe 
transferred. If Mwuf<L>> = 0* tne driver will cause no transfer* but 
win oositicn the appropriate disc unit at the specified bloc*. 

The disc or i ver is called bv JSd DISCA*I. 

The driver determines the loajc^l nisc on which the specified 
block lies* and. if that looical disc is present on the system* 
processes the reouested transfer. While a reauest is be i nq 
processed anci transfer t-^Kina Place* the driver busy flao* *bUSY* 
is set to -1. If the ir i ver is called while MbuSY is so set* it 
will return without coma anything. if the disc bloc* number 
passed to the driver does not lie on one of tne discs present on 
the system, the driver will increment tne return address by one 
and return witnout do i nq anvthlna. if the driver accepts the 
request* it will increment the return aaaress py two and return - 
after orocessina of the reauest has been initiated. 

A movinq head aisc transfer involves two steps: positioning tne 
heads to the correct area of the disc ana Performing the actual 
data transfer. The aisc driver returns to its caller while each 
of these is going on. Command channel interrupts return control 
to the driver when the ooerations ar * complete: tne driver checKS 
for successful completion of the ooerations before proceeding. 
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6: 
1: 



A sinile data transfer on a olsc cannot automatically continue 
from one cylinder to the next. The 7s»0u disc has the further 
restriction that a transfer cannot cross the "ml d-cy I I nder •• 
boundary (between tracK 1 and tracK 2) • when a data transfer is 
reauestoo which crosses one or more of these boundaries* the disc 
driver breaks up the transfer to conform with the restrictions. 

When the driver completes handling a reauest and returns to the 
caller* MtiUSY is set to indicate the outcome of the transfer as 
f ol lows : 

The requested transfer has been successfully completed. 
The transfer has failed} the seek (Dosition) operation 
could not oe comoleted. 
2: Tne transfer has failed; the data transfer was 

unsuccessf u I . 
3? The transfer has fai lea; part of the data lies on* or 
would oe written to* a disc which is not present on 
the system. 

A complete disc transfer can be performed by the fol lowing 
seauence : 

JSP. DISC a, I 

<return for driver ousv> 

<return for disc not oresent> 

LDA MHUSY 

SSA 

JMP •*-(> 

SZA 

<process aisc error> 

<crocess successful transfer> 

The disc driver does not modify the contents of mwoPD and the A 
finri h reaisters. The system ne^er suspends a orogram for a disc 
trans f er . 
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SYSTE-.M CONSOLb Q*IVE.k 

The system console or i ver mainains three flags* TJ5F1* T3bF<£* and 
T3SF3* which determines Its status, The meaning of these flags 
are as foil ows : 

T35F1: = -1 driver is busy* otherwise 

T3SF2: Normally 0* It is set to -1 tiy the driver at the con- 
clusion of incut* and cleared to u externally, 

T35F3: Normally 0* it is set to -1 by the driver at the con- 
clusion of inout* and cleereo to u bv tne driver after 
output has been initiated. 

The comoinea values of tnese flaos are more significant: 

Fl F?. K3 
Or ivpr is accept! no input 
—1 -1 Inout command received ana is beina processed* out 

output has not been initiated. 
-1 Outout terminated from a systen command which is to be 
re i n i t i ated. 
-1 out putting 

-1 -1 o outputtino, *tt the end of which the current system 
command will be reinitiated, 

when r<2 = -l, tne or i ver will not acceot a^y inout. This 
nu«r *»ntees system library programs that they will not oe 
interfered with. These routines are responsible for clearing 
F? *hf>n they call the iriver .for the last time, F2 and the 
console status (T3bST) Are clo.arod if a Key is struc* on the 
console durina outout for certain con sole routines. This will 
effectively terminate such routines as f>I *ec tor I es * REPorts and 
SI Atuses • 

When F3 = — i* log-on and loa-off reports as well as tne message 
oueue are he l a off. Inis Guarantees that tnese messages will 
not hp interfered witn bv the system imrary program outout. 

Fl when set will nolo off I oo-on and loa-off reoorts as well as 
the nessaoe oueue. fl is set ourina outout* Fl is also set for 
(SO sec) whenever tne user orosses a key (except CR), 

IEaMia£I-3Y.SILtf,C0&S)QLE 

Tn« following variaoles *nd fiaos are also* maintained for a 
ternmet console ny the console driver, Tnese r^re necessary 
because the console must r*n turnea off after its neen idle for 
flonrox i mate I y 50 seconds ano turned on aaain +nen there- is output 
to he printen. The terminet console a • so rpauires fill 
characters after a Lf , 
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Hit IS if s>et indicates a terminet console 
TD: Normally « 1 when a motor shutao*n is in Drogress 
Tnsu: Normally G» 1 when a motor shutdown is In progress 
fMTST: Contains the motor state is off* 1 if on 
TFCNT: Contain number of fills left to outout 



The calling ssauence is: 

A; bit lb = if CRLf is to be aooended* oits (14S0) 

chars • 
B: oit 15 = 1 if punchinn is to ta*e Place 

orintinq. bits (l**:o) = core aadress 

JSe TTY35,1 



# Of 



i n add 1 1 i on to 
of outout buffer* 



The driver uses tne 36 word buffer T35BF as an inout ouffer. 
^ost of the liorary routines use it for output* and occasionally 
for teriDorary storage between lines of output. 
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SYSltf* PkOCfc SSOK-I/O PNOCbSSOK 
- COMMUNICATION 
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I. PbQCtSSQtf-I&IfctsCQ&fclfcCI- 

The block diagram for the Processor Interconnect Is on the 
second page following. in the IDLE state* the interface cards 
are set up as follows: 

CI (CHI) CONTROL & ENOCODF: SET 

FLaO fw IRQ: CLEAR • 

C2(CH2) CONTROL &. ENCODE: CLEAR 
FLAG: SET 

INu: CLEAR 

A data transmission operation occurs thusly: 

1. benoing machine waits for f I aa to be set on C2(CH2) 
indicating that the pr^vi^"* transmission has been 
processed. 

2. benaing machine olaces data word in output register of 
C2ICH2) thereby placing it on the input register of CHI 
(CI) . (OTA/b CdiCnd) ) . 

3* Senaing machine issues STC, CLF to C2(CH2) making the 

ENCODE LINE go high, setting FLAu on Chi (CD* clearing 
ENCODE on CHi(Cl)* and strobing the data word into Chi (CI). 

4. Sending machine issues CLC to c*MCH2) to Prevent an 
interruot from that card. The sending machine is now 
free to return to other tas,<s. 

5. in the receiving machine* Tb will set the IRQ on CHl(Cl). 
If the interrupt system is enabled and the priority line 
is hign, the Iku will cause an interrupt to a service 
rout me. 

6. The service routine does an LIA/a from CHI and decodes 
the 16 bit data word. 

7. If a response is cat lea for, the receiving machine can load 
the output register with a data word (oTA/d CHl(CI)). 

8. when the receiving machine has completed its processing, it 
issues an STCCICLF) to CHl(cl) which restores the cards to 
the idle s tate. 

The following is the resultant statuses of the sending two 
computers after a command has been sent, received and 
acknow l eoged : 
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a) The f I aq is set on Ci(CH'd) of the sending computer 
indicating that another transfer is now allowed. This 
occurred when the receivino. computer issued an STCtC to 
CHI (CI) after it had oecoaed ana executed the command. 
The STC»c is the acKnow ledgement to the SEND conputer 
that the KtCtilvt computer dici receive tne transmission. 

b) The control on CH(CH2) is cleared by the CLC to 
'C2(CH2)# This was done to inhibit the interrupt that 

normally would occur after the ShN(> computer outoutted 
the command. 

c) The control is set and the flag is cleared on CmI(CI) 
(from the STc«C acknow l edaement ) maicatim readiness 
to receive another transmission. 
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SYSIEfeJ-ttiOCESSQB-CQMbUfc»ICAliQfc>lb-.IQ_IZQ-BeQC£SSQS 

The system processor sends communications on I/O 11 channel and 
receives them on i/o channel 10. An exception is a communication 
sent by the system processor which requires a response* which 
win be received on l/o channel 11. communications are initiated 
by JSfi SDVRP»I with the communication in the A register* 

The system processor can initiate requests and commands for the 
I/O Processor, Six of these are of general nature (i.e. not 
limiteo to a single user). They include PHS* PRR» RJE» SCI and 
TCm. 




Commands concerned with control of ASCII devices are STR* AOVt 
ROV, AL«# XHb and kDO. 
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CCdfi-EOCCDfitS 



15 



U 12 



4 7 



OP coot 



PORT 4 



DATA FIELD ! 



lb 13 U 7 b 

J OP CODE DEVICE * DATA FIELUJ 

• — — — — --.--- — — -.-»-_---.--. — - — -.- — _-. — -.-.•-.•-.- • 

The above format holds for command cooes thru 5 

Command codes 6 ana 7 are micro-coded and have one of the 
following formats: 



lb 



13 Id 







OP CODE 



POPT 4 



MICRO 
COUE 



15 



13 Id 



OP CODE 



DEVlCt H 



MlCNO 
. CODE 



Commands in the above format which must suodIv data are two word 
commands with the aate supplied in the second word* 



4-14 



bYSTEM PROCESSOR — > I/O PROCESSOR 



Numer i c 




Value of 




oe.- cqqs 


WOSQJQOic 





POC 


1 


STL 


2 


STH 


3 


PHS 


4 


PO 


5 


POS 


6 


Ml*kO 


7 


MIKRO 


MlKRO 




fcJiCCQCQde 


t?OSQ32DiC 





(unused) 


1 


wTH 


MIKPO 




MiCCQCQCfi 


MOfifflSQiC 





PRR 


1 


UIR 


2 


UNK 


3 


IwT 


4 


HUU 


5 


ULO 


6 


ECO 


7 


ECF 


10 


TPO 


11 


STH 


12 


NUC 


13 


KTu 


14 


ALI 


1ft 


OwT 


16 


IbM 


17 


ADV 


20 


RDV 


21 


ALb 


22 


XRb 


23 


dKS 


24 


KOO 


25 


FNC 


26 


RJt. 


27 


AbT 


30 


PIS 



DSSCCiBiiOQ 

Process output character 
Start ENTER Timing 
Subtype information 
Phones timing parameter 
Perform control function 
Process output string 
Micro code group 
Micro code group 1 



OfiSCCietiSQ 



what terminal type 



UfiSCXletiQQ 

Initialize IOP/preempt reauest 

User is running 

user not running 

input wai t 

Hang user up 

User logged on 

Echo-on 

Echo-off 

Tape mode 

Start timed retries 

New user ca I I ed 

Kill terminal outout 

A » I ow i nput 

Output wa i t 

Is bu f f er a va i I ab I e 

Al locate devi ce 

Release device 

a I I ocate buffer 

Transfer input puffer 

Backspace terminal puffer 

Kill dev i ce output 

Fet next character 

RJE command 

User is being aborted 

Process input string 
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31 
32 
33 
36. 
35 
36 
37 



(unused) 

SCI 

KLb 

SSU 

SBP 

UttH 

TCM 



Sena core imaqe 
release buffer 
System shutdown 
Save buffer pointer 
release buffer pointer 
Transmit console message 
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eoc 

The orocess output character command contains a port number In 
bits- 13 thru 8 and an ASCII character in bits 7 thru 0. The 
character is to be Placed in the port's output puffer. 

Sit 

The start enter timing commana contains the Port number in bits 
12 thru 8 and an integer between 1 and 25b in pits 7 thru 0. The 
integer specified is the maximum number of seconds the user port 
is to be enabled for entering a line of data. If the time 
elapses without the user completing a line* the loP returns the 
command ETO. Otherwise the IoP returns the command HVL which 
contains the actual response time in bits 7 thru u. 

SIS 

The suDtype information command contains the port number in bits 
12 thru 8 and the terminal type cope in pits 7 tnru 0. The 
terminal type code is an integer between and 8 and specifies 
the terminal type of the port. This command is sent by the SP to 
the IOP when the SP is executing the HELLO command and has 
evaluated the terminal type parameter. 

eas 



The phones timing parameter contains an integer value between 
and 255 in bits 7 thru o. This value is the number of seconds 
that a user is Permitted for logging on. This command is sent 
when the system operator issues the PHONES command at the system 
console. If no command is given, the default logon time Is 120 



seconds • 
ECE 



The perform control function command contains a logical unit 
nurner in bits I'd. thru 7 and a control code In bits fa thru 0. 




function in a PRINT statement list. The IOP returns a word 
response. See the section on I/O responses for possible retur 



va I ues • 
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eos 

The process output string command contains a port number in bits 
12 thru 8 and an integer character count in bits b thru 0. This 
command signals the IOP that the SP is ready to transmit an 
outout string to the specified port. The lof- sends the SP a one 
woro response - zero if ok to send the string, non-2ero if not. 
If it's ok to send, the SP sends the string using DMA. If not, 
the loP will seno a dFE command to" the SP when a buffer becomes 
&va i I ab i e. 

*ie 

The what terminal type request contains a port number in bits 12 
thru fc. The IOP senas the SP a one word response containing the 
inteaer value of the soecifiea port's terminal type. This 
commana is sent when a HASIC program executes the SYS commana 
with parameter 4. 

pay 

The initialize lOP/preempt request is sent by the loader and 
never occurs during normal system operation. See loader for 
addi t ional oetai Is. 

The user is running command contains a port numoer in bits 12 
thru ft. This command is sent to the IOP whenever a user program 
beams execution on the specified port. 

The user not running command contains a oor t numoer in bits 12 
thru 8. This command informs the IOP that the user program on 
the specified port is no longer running due to normal termination 
or orogram error. 

1*1 

The input wait commana contains a port number in oits 12 thru B. 
This command is sent to the IoP to enaole input on the specified 
port. The SP then susoends the port with status of input wait. 
The IoP will wake the user with a HVL» nvP» or HLL. 
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The hang user up command contains a port number in bits 12 thru 
8. This command is sent whenever a user executes the BYE command 
or if the jettison port routine determines that the user swap 
tracks is unusable for the specified port. 

ULQ 

The user togged on command contains a port number in bits 12 thru 
8. This command informs the IOH that a user has successfully 
I oaqea ont.o the System. 

fcCQ 

The echo-on command contains a port number in bits 12 thru a. 
This command is sent to the IoP vhon the user at the specified 
port executes the tCHO-ON command. The effect is to initiate an 
echo for full duplex terminals. 

fc'CE 

The echo-off command contains a port number in bits 12 thru ti m 
It is sent to the ion when the user at the specified port 
executes the ECHO-ufF command. The effect is to inhibit echo 
for nal f-ouplex terminals. 

IEQ 

The tape mooe command contains a port number in bits 12 thru 8, 
This commana is sent when the user on the specified port exe- 
cutes the TAPE commana. 

SIS 

The start timed retries command contains a logical unit number in 
bits 12 thru 7. This commanc is sent after an unsuccessful i/o 
operation was attemptea on the specified device to retry the 
operation. The 10^ will return a WUU whenever the retry is 
successf u I • 
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NUC 

The new user callea command contains a Port number in bits l«2-8. 
This command is sent to inform the IOP that the user logged on 
the specified Port is executing a HELLO command. 
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The kill terminal output command contains a port number In bits 
12-8. This command Is used to completely purge any output cur- 
rently in the specified port's IOP buffers. It is sent when the 
user hits BREAK* if the system operator types SLLLP* or If the 
SP is shutting down the system due to a hardware failure. 

£LI 

The allow input command contains a port number In bits 12-a. 
This command is sent to the IoP to enaole the specified port to 
enter lines of syntax when the terminal is in tape mode. 

QUI 

The output wait command contain" * nort numeer in bits 12 thru 8. 
This command tells the IoP to send a BfT command when the 
specified port has a buffer available* The SP sends this request 
for user terminal commands which generate several I l„nes of 
outout. This allows us to re-schedule the user after he has 
successfully output a line and a terminal puffer is once again 
ava i I ao I e. 

Ib£ 

The is buffer available command contains a port numoer in bits 12 
thru 8. This command is sent when the system operator is 
executing an ANNOUNCfc and the IOP returns a one word response 
indicating either buffer availabte (response =0) or not available 
(response <> 0). when the response is affirmative the SP will 
send the message via PnS. 

The allocate device command contains a logical unit number in 
bits 12 thru 7. The second word of the command indicates the 
size of tne buffer which should be allocated for the specified 
device. The IOP returns a one word response indicating success 
(response = 0) or device busy (response <>• 0) . This command is 
sent whenever an ASCII file is opened on a given IoP device. 
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RDV 

The release device command contains a logical unit number in bits 
12 thru 7. This command tells the IoP that the specified device 
is no longer needea and that all remaining Duffers for the device 
should be written and then de-allocated. The IOP returns a one 
word response. See section on I/O responses for possible return 
values. 

fiLB 

The allocate buffer command contains a logical unit number in 
bits Id thru 7. The second word of the command contains the 
length of the output buffer in bytes. The ion then returns a 
one word response. If the response is zero* then the SP sends 
the output buffer to the IOP via DMA. See section on i/o 
responses for other possible return values. 

XBb 

The transfer input buffer command contains a logical unit numper 
in bits 12 thru 7. The IOP returns a one woro response 
indicating whether it has a full input buffer on the soecifiea 
device. If it does (response =0), then the SP acknowledges the 
response (STC«CLF) and then the next word on the send channel is 
the size of the puffer (in bvtes). After acknowledging the 
buffer size the SP transfers the input buffer using DMA. The SP 
acknowledges receipt of the buffer by another STC» CLF. 

UKS 

The backspace terminal puffer command contains a port number in 
bits 12 thru b. The command causes the iop to backspace the 
specified terminal's input puffer pointer one character. 

tDQ 

The kill device output command contains a logical unit numper in 
bits 12 thru 7. This command tells the iop to completely Purge 
and de-allocate ahy buffers or activity on the specified device. 
Usually sent due to unrecoverable I/O failures or abnormal 
program termination. 

EfcC 

The fetch next character command contains a port numper in bits 
12 thru 8. The IOH returns a one word response which is the next 
character in the specified por t • s inout buffer. The input 
buffer Pointer is advanced to the next character. 
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The remote job entry command contains a word count in bits 12 
tnru 7. The command is sent when the system operator types an 
Rjj£ command on the system console* The word count is the length 
of the message. The IoP always rejects the RJE command the first 
time. The IOP will send WRU when it is ready for the message. 
The Rjfc Command is then guaranteed to be accepted and the message 
is then transmit tea to the IOP via DMA. 

The user is aborting command contains a oor t number in bits 12 
thru 8. This command informs the IOP that the user program on 
the specified port being aborted due to the user hitting the 

BREAK Kb. Y. 

BIS 

The process input 'String command contains a port numoer in pits 
i 2 thru 8. Tne secona word is the buffer lenqth which the 
specified port has allocated for input. The IOP responds with 
the actual numoer of Characters it has ♦ which will oe < the 
specified buffer length. Tne SP acknowledges the ouffer length 
with ^ STC« CLF and proceeds to transfer the input buffer via 
DMA, The transfer is acknowledged with an additional STo CLF. 
If the IOP actually had more characters than would fit in the 
port's SP buffer* it will transfer one buffer full and remember' 
the buffer position. a subsequent PIS reouest will receive 
characters starting from the position that the previous reouest 
f i n i shed • 

SCI 

The seno core image command contains a word count in bits 12 thru 
7. The second word of the command i*s the starting address. The 
IOP responas by sending the specified number of worrds* starting 
with tne specified adaress. The SP receives the response via 
DMA. Tnis command is sent when the user AUOO uses the DUMR 
command to dump the IOP memory. 
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RLB_ 

The release buffer command contains a port number in bits Id thru 
H m This command is sent to force the IOP to print and release 
any output which is in a buffer for the specified terminal. This 
command is sent by the SP whenever it wishes to ensure that all 
user output has been Printed (i.e. whenever a port is swapped 
out ) . 

SSD 

The system shut aown command is sent to inform the IOP tnat the 
system is being shut down due to the system operator ^executing 
the SLfckP command, 

SBB 

The save buffer pointer command contains a Dort number in bits 
12 thru 8. This command tells the IOP to save the current value 
of the terminal input buffer oointer on the specified Port. The 
pointer value can be restored by the RBP command. These commands 
allow the SP to reaa the next few characters in the buffer (via 
FnC) and to return to the current position without sending 
mul t iPl e BKS» s. 

Bee 

The restore buffer pointer commana contains a port number in bits 
12 thru 8, This command tells the IOP to restore the terminal 
input buffer pointer on the specified port to the value saved via 
a SBP. 

ICU 

The transmit console message command tells the IOP to send a 
console message to the SP. The transfer is hanaled via OMA, 
This command is sent by tne SP after the SP has received on SCM 
command from the IOP, 
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JLZQ-tffcStiQtslSifcS 

SP. The possible values are as follows: 

-3 No data available on RJE or LT 

-2 ena-of-f Me 

-1 buffer not reaay 

u operation successful 

1 device not ready 

2 dev ice error 

3 attention needed 

4 read/write failure* 

In the case of a -1 resoonse* the IOP will send a wuu for the 
appropriate device when a buffer becomes available* If the 
response is greater than • the SH will eventually send either an 
SIR (in which case the Iop will send a wUU when the condition has 
peen fixea) or a kog. 
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I/O P^OCLSSOK COMMUNICATIONS TO SYSTEM PPoCtSSOR 

The system processor receives communications from the I/O 
processor on l/o channel 10. The system processor ignores 
inconsistent communications* e.g. ecceots a line of input only 
when the user's status is IDLE or INPUT wait. The receive driver 
communicates with the scheouler by setting the. PACT bit in the 
?FLAG word of the port's teletype table and setting the 
aporoDnete status. 

Communication requests initiated by the I/O Pocessor are dividea 
into three general groups. user port commands affect one 
particular Port ana incluae HVL« HLP* HLL« At>*« WFL* dFE« frTO and 
UHU. Another group affects operation of the PJt facility and 
includes SCM» AUK* kup. and WPU. The remaining commana» WUU» 
concerns operation of « non-shareable aevice. 
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NUM&HIC 








VALUE OF 








Q£__CQUt 


<3fcJtfc!G&IC 


QtscexeiiQcj 







HVL 


Have a 1 ine 




1 


HLf 


have a li ne - 


par i ty error 


2 


MLL 


Have a Hne - 


lost character 


3 


(unused ) 






4 


(unused) 






5 


(unused) 






6 


(unused) 






7 


MJKRO 


Micro codea 
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MIKRO 


-CODE 





1 


? 


3 


4 


5 


h 


7 


10 


11 


12 


13 


14 


15 


lh 


17 



Muttaubic D£&CBieiia& 

ABR User abort reauest 

bFL Buffer f u I I 

dFL buffer empty 

CTO tnter timed out 

UHu User hung up 

SCm Send console message 

AUK Allocate device for RJE 

ROR Release oevice from Rj£ 

wuu wake user up 

WKU hdKG RJK UP 

(unused) 
(unused) 
(unused ) 
(unused) 
(unused ) 
(unused) 
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CQDE.EOfcittalS 



lb 13 12 8 7 

! "coul port""* data'field" J 



Command code 7 is micro-coded and has one of the following 
formats : 



lb 13 12 a 
CODE " " K)WT n~ 



MICKO 
CODE 



lb 



13 12 







CODE 



DEV P 



MICWO 
COOE 



lb 



13 1<- 



CODE 



DATA 



MICRO 
CODE 



Thpse commands contain a port number 
response time in bits 7 thru 0. The 
user on. the specified port has input 
by a carriage return. The response t 
numner of seconds that it took the us 
was sent in response to an STE reoues 
saved in the user teletype table. Th 
in tne port's teletype table only if 
or input wait. The IktRR bit is set 
Each of the commanas causes the user 
different address. 



in bits 12 tnru 6 and a 
commands indicate that the 
a complete line term inated 
i me field contains the 
er to respond if the line 
t by the SP. This value is 
e SP will set the PACT bit 
the user's status is IDLE 
if huP or HVL was received, 
to be re— scheduled at a 
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ABR 



The abort command contains a port number in bits id thru 8. The 
SP receives this command when the user on the soecified oor t has 
hit the bHEAK Key. If the user has disabled oreaK (PbTLG=l) and 
the svstem operator has not re-enabled it (CBFLG=0)» the ABTPY 
bit in the user teletype table is set. AdTPY is also set if the 
system is executing critical cooe and has set tne UNAbT bit, A 
special check is made to allow the user to abort out of the LOAD 
command if his status is output wait or pause. If oreaK is not 
disabled and UNAdT is clear* then a checK is made to see if the 
user is in an unabortable library Droaram, If not* his status i! 
set to AbOPT and the pact hit in the part's teletype table is 



set . 



btL 

The ouffer full command contains a oort number in bits Id thru b. 
Ths command indicates that the specified port's output buffer is 
full. when this command is received* the SP sets the OUTPUT WAIT 
bit in the port's teletype table. This bit is always cnecKed 
prior to issuing a HOC for the Port ana the user is susoenaed 
penni ng bF t if it is. 



BEE 

The buffer empty commana contains a port numoer in bits id thru 
8. This command inoicates that the. specified port now has ar\ 
output cuffer available. upon receipt of this command, the SP 
clears the OUTPUT wmIT bit in the Port's teletype table. If the 
port's status is OUTPUT wAIT (indicating that tne user is 
susoonoeo due to a rejected POS or a delayed PoC>» then tne PACT 
bit is set . 



tlu 

The enter timed out command contains a oort number in nits id 
thru H. This command indicates that the time period specif iea in 
and STfc command has elapsed without the user at the specified 
port having typed a complete line. If the Port's status is not 
currently ABOPT « his restart address is incremented twice* his 
status set to TlMtoUT. and his PACT bit is set. 
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UHU 

The user hung up command contains a port number in bits Id thru 
P <» This command. inai cates that the user on the speci Hed port 
has disconnected his terminal. If the user's status is currently 
syntax or library Program running and he is at the head of the 
queue* HQUIS is set. otherwise the user status is set to 
DISCONNECT and the PACT bit is set. 

SCt} ■ * 

The send console message command contains a message lenqth in 
bits Id thru 7. This command informs the SP that the loP has an 
WJE message for the system console. The SP saves the message 
length in CONML. At a later point in time the scheduler will 
reauest the message via a TCM command. 



The allocate device for nje command contains a logical unit 
number in bits id thru 7. This command is a request from the IOP 
to allocate the specified device. The SP cnecKS the device table 
and if the device is available allocates it to WJE and returns 
a zero to the loP. If the device is not available* a minus one 
i s returned • 



The release device from Mje request contains a logical unit 
number in bits I'd thru 7. This is a request from the loP to 
release a device which was allocated in resDonse to an ADk. 



The wake user up commana contains a logical, unit number in bits 
12 thru 7. The command maicatcs that the specified device has 
oonp ready* an output buffer is availaole. or an inout buffer is 
ready. This command is received to wake up the user controlling 
the device when he hos been suspended after an STU command or 
after a -1 response was receivea-for a PCK* ALd* XR8* or RDV 
command. Tne SP Iooks at the status of the port to which the 
soecif tea device has been allocated. If that port has a status 
of either input wait or output wait then the OUTwT pit in the 
Dort's teletype taole is cleared and PACT bit set. 
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fe&U 

The waKe hJE ud command has no Parameters. when received it 
signifies to the SP that the IOP is no* ready to accept the RJE 
commano which was previously rejected. The SP checxs that an 
KJE message is penotna ana sets kjfF6= -1 so that the scheduler 
can re-send the kjt reauest, 

The two processors in the time share system nave independent 
Power supplies ana conseouent l y * power failure interrupts in 
either machine may occur at Different times. 

A problem arises if one computer is po*erea aown* ana the other 
machine attempts to send a transmission. Date will be lost as 
well as possible suoseauent data transmissions. This is 
aPDarently caused by stray encooe and data levels while power is 
coming up. 

The external conseouences of a lost data transmission are these: 

1. A line (syntax* commanc or input) being processed will oe 
garbled. 

2. output Characters will be lost. This problem will be hidden 
by the fact that the current output Character is garbled 
(mux Quits senoing during cnaracter). 

3. Terminals on which a carriage return has come in may ne\/er 
nave that line processed by the system processor. The 
terminal will not accept input and the oreax Key must be 
used to re-establish communications when Dower is restored. 

4. The system processor may lose the signal that inaicates 
that the buffer for this user is almost emoty. The 
terminal will stop tyPina ana the program will remain in 
I/O suspend. The preak key must be useg to re-estab I i Sh 
communications when oower is restored. 

5. If several users are typing on the l/o processor and the 
system processor is not runnina* all multiplexor activity 
may cease (I/O processor waiting for transmission to be 
acKnow I eagea) . This leads to the classic symptoms* i.e.* 
no response to any struCK Key (even preaK)* ana termination 
of all output operations* Perhaps with a soace on the line 
(teletype chatter ina) . 
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If the primary power source fails* the two machines will qo down 
within milliseconds of one another and it is not so likely that 
any transmission will be in progress thereoy being lost. If» 
however, only one processor's power is lost, one of the above 
symptoms is sure to occur if there is significant activity on the 
system. 

To solve these proolems* a cable is installed between the two 
systems. This cable causes the power to fail on both processors 
whenever a power fail is detected on one processor. Because one 
processor fails within nanoseconds of the other* the probability 
of aata oeing lost or of a oort lockout »s minimized. 

unfortunately, some comoinations of different hardware processor 
models oo not Permit use of the above mentioned caole. If the 
primary power source falls* both Processors will power down 
almost simultaneously, mitigating the probaoillty of the above 
Droolems occurring. If, however, only one orocessor loses power 
dunna normal system activity* there is almost certain to be some 
transmission loss, consequently* if the system must be manually 
oower od-down, either use a common power switch or turn off the 
I/o -Processor » s power first. in this case the I/O Processor 
shoulrj be powerea-uo last when resuming system activity. 
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lQgic-Q£-tbg-I5e*k-e2secT£ail^eQwfiCTue-&euUQgs 

The TSB/G power-f ai I /Power-up recovery routines in the two 
processors reaulre close coordination to properly restore the 
interconnect kit. All of the following contingencies must be 
covered by the design: secondary power failures during one or 
both processor recovery routines* Initiation of recovery oy one 
processor before completion of the poweraown routine by the other 
Processor* power failure during a DMA transfer on the 
interconnect* and power failure following a system shutdown but 
before the system restarts aqain. The strategy discussed below 
provides the mechanisms and restoration sequencing necessary to 
recover from any combination of these* 

Each processor must maintain six words of information. one of 
these* POWFF* is a flag local to the oower-f a i I /oower-uo 
routines. It is usea to assist in identification of power 
failures occurring aurjnq recovery from a preceding one. RCHNO 
ana SCHNO contain the last word sent (exclusive of a DMA 
transfer) on the interconnect receive and send channel 
respectively. These are obviously needea to restore the state of 
the interconnect. DMaFL is a state variable containing the DMA- 
on-i nterconnect status of the processor program. it is used to 
determine if the Power failure disrupted a DMA transfer. The 
final two words record the length, starting memory address* and 
direction bit of the most recent DMA transfer on the 
interconnect. Their existence allows the recovery routine to 
restart an aborted transfer. 

Since the oraer in which the processor will complete their 
recovery routines cannot oe predicted* two seauenclng 
reauirements must be observed. First* each word Placed on the 
interconnect Is to oe recorded in either RChno or SCHNO as 
appropriate before issuance of the »STC n»c 1 wnicn signals its 
presence to the other processor. Second* neither processor can 
proceea to its interconnect DMA routine until after execution of 
the last instruction afectinq the system processor's send flag 
and I/O processor's receive flag* regardless of which processor 
will execute the instruction (i.e.* one processor may nave to 
wait for its flag to be set by the other processor). This 
condition is automatically met by the hanasnake requirements of 
POS* AL6* ano PJt. It is also a fallout of the design for SCI* 
TCM, ana the requests for the device table or COLDDUMp core 
image. However, use of xkb requires that the I/O processor wait 
for its receive flag to become set* af ter transmi t t i ng the 
transfer length wora* oefore invokinq its interconnect DMA 
rout i ne . 
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The power-down routine distinguishes between four possible 
cases, 1) If Power fails our i nq normal tine-sharingi 
POwFF s and the restart address is not within the recovery 
procedure. Both processors must save their hardware registers 
ana the flag states of the interconnect and interrupt system. 
The system processor (SP) also records the flag states of its 
Peripheral devices, 2) If power fails while the SP is not 
time-sharing (during System shutdown* system loading* or after 
the SP has completed shutdown or failed)* the SP will not save 
its state or attempt to recover. The I/O processor (IOP 
is normally still active (waiting for the SP to signal resumption 
of system activity) ano does not distinguish this case from the 
preceding one. 3) POwFF = 1 identifies a power failure from the 
recovery routine prior to restoration of the interconnect. Since 
no system acitivity has occurred on either processor as yet* 
their current states are ignored and recovery begins anew from 
the information recorded at the initial failure. 4) if powFF = 

2 or the restart address lies within the recovery routine* then 
the interconnect was restored but the Processor had not net 
completed the remainder of its recovery. This differs from case 

3 in that the other processor might have completed its recovery 
and returned to its ore-failure activity. having done so* it 
might further have executed ah instruction which legitimately 
altered the state of the interconnect. Each processor is 
responsible for correctly restoring its send channel 
(simultaneously restoring the other processor's receive channel). 
Thus the processor in this situation need only determine if its 
send channel flag is not set (it could not nave been cleared by 
the other processor) and* if so* overlay the previously recorded 
state. The state variable omaFL allows detection of aborted DMA 
transfers on the interconnect. It'must be set to zero whenever 
time-sharing begins in order to synchronize the processor states. 
Each entry to the interconnect DMa routine first saves the 
transfer parameters arid then increments DMAFL to the next odd 
value. when the processor's hardware DMA flag comes set* it 
increments its DmaKL to the next even value* executing not less 
than three instructions (including the SFS 7) to ensure that the 
other processor has time to complete its current instruction* 
last cycle for DMA channel 7., If the last two bits of both 
processor's state variables are even (uO vs. 00 or 10 vs. 10) 
then no transfer is active. OMAFL will be Odd (01 or 11) while 

a processor is in the critical portion of its transfer routine. 
The other processor's DMAFL will be one less (00 vs. 01 or 10 vs. 
11) if it has not reached its transfer routine* or will be eoua I 
(01 vs. 01 or 11 vs. 11) if also in its transfer routine* or will 
be one more (lu vs. 01 or 00 vs. 11) if the transfer completed. 
The remaining combinations (00 vs. 10 or Oi vs. 11) cannot occur 
since the processors can never be more than one state apart. 
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The loP power-up recovery routine is straightforward except for 
restoration of the interconnect. It begins py setting POwFF to 1 
and then re-enabling power-fail interrupts. Since recovery 
reauires an exchange of information* the IOP must clear its 
receive channel flag and then wait enough time for the SP to 
complete its power-aown routine* clear its receive channel flag* 
and transmit its data. The IOP routine does this by 
Incorporating a timing factor into its wait loop. If the loop 
times out* then the Sh must not be active and the [OP should 
restore itself to the same state as it woulo be in following 
reception of a SSD from the SP. After clearing its receive 
channel flag* the SP will execute at least eighty Instructions 
(allowing ample time for the IOP to reach its wait loop) ana then 
send « wora containing zero bits except for the direction hit of 
the last DMA transfer (1 if from the IOP* u if from the SP) in 
bit ana the last two bits of Its DMAFL in bits d and 1. The 
recovery routines are not in synchronization. The IOP responds 
with its most recent DMA direction bit (0 if from the I0P» 1 if 
from the SP) and the low two bits of its DMAFL in the same 
format. 

At this point ooth processors have a complete record of the 
i nterconnect • ts state at Power-fail. The Iop automatically 
Places the current value of KCHNO on its receive channel and 
sends it to the SP. If the IOP»s DMAFL is odd and the SP»s 
information indicates that the transfer aia not complete* the IqP 
makes a note to reinitialize its DMA routine later In the 
recovery process. The iop now waits for the SP to set the lOP f s 
sena channel flag. when this occurs* the IOP examines its record 
of the flag at the time when power f ai lea. If it was clear* the 
IOP restores the wora from sCHho ana issues the *STC n*C to 
transmit it. Finally* PowFF is incremented to d since the 
interconnect is not completely restorea (the SP will not finish 
its recovery until well after the iop finishes all of the above). 
The remainder of the Iop routine consists of ensuring that an 
aDorteo DMA transfer on the interconnect will pe restarted* 
Performing the Out-of-iine device recovery routines* resetting 
POWFF to after returning to the oower-up routine* restoring the 
hardware registers ana interrupt system flap, ana resuming t i me- 
shar i ng. 

The SP recovery routine is somewhat more complex. It first sets 
POwFF to 1 and re-enaoles Dower-fail interrupts. Tne SP then 
reconstructs the possible nesting of power-fail* receive channel* 
system console* ana time-bese generator drivers. It does this by 
comparing the return address of each active routine (power-fail 
is flfi £sclQ active to initiate this search) with the ooundarles 
of the lower-priority routines it might have interrupted. Each 
flag which was clear at the power failure is cleared during this 
process (the receive Channel flag is always cleared here) ana an 
interrupt is forcea for each active routine whose flag was set* 
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to clear the flag buffer and prevent a false interrupt later* At 
least eighty Instructions will be executed by completion of this 
activity. The SP assumes that the IOP has reached the wait loop 
of its recovery routine and transmits the information word 
described above on its send channel. The two processors are now 
in synchronization. 




At this point both processors have a complete record of the 
interconnect »s state at power-fail. THe SP waits for the IOP to 
set the SP's send channel flag and is then ready to Perform f Ina 
restoration of the interconnect. if 'both processors were in 
their DMA routines or one was and the other had not yet reached 
its* then the abortea transfer must be restarted. The SP either 

SP 
* it 

. „ , ~- .... ,--■ -. . . ...„ .,-..-.-. ..-- -. it 

leaves the routine's length parameter at zero. If neither 
processor was in its DMA routine but the SP • s send channel flag 
was clear* it restores the word from schno and issues the 
• STC n*C» to transmit it. Finally* the SP automatically places 
the current value of fcCHNO on its receive channel » sends it to 
the IOP (which is waiting to restore its send channel)* and 
increments POWFF to d to singnal restoration of the interconnect. 

The SP now completes preoarations for restarting an aoorted 
i nerconnectterconnect dma transfer. it checKS the return address 
of each interrupt routine* except those which were identified as 
interrupting other interrupt routines in the logic above* to see 
if it lies within the critical portion of the transfer routine. 
For those that ab* the return aoaress is replaced with the 
transfer restart instruction's address. This will have no effect 
except for the one (if any) active routine which actually did 
interrupt from the transfer routine. If the transfer had 
completed* the length word was left at zero and the restart will 
not invoxe DMA. If a transfer was aborted* then the parameters 
were restored above and the transfer will be repeated correctly. 
The remainder of the SP routine consists of performing the 
out-of-ilne aevice recovery routines* resetting POWFF to 0* 
restoring the haraware registers and interrupt system flag* and 
resuming t i me— shar i ng. 
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SE 


joe 


00 


00 


00 


01 



Possible DMAFL Comb » nations 



Neither processor in its transfer routine, 

IuP aoing transfer* SP not yet to its transfer 
rout i ne.» 

01 00 SP doing transfer, ioP not yet to its transfer 
rout ine,# 

oi 01 doth SP ana IOP in their transfer routines** 

01 lu SP in its transfer routine but transfer is 
complete. 

10 01 IOP in its transfer routine but transfer is 
complete. 

10 10 Neither processor in its transfer routine. 

10 11 IOP doing transfer* SP not yet to its transfer 

rout i ne.# 

11 10 SP ooinq transfer* inp not yet to its transfer 

routine.* 

11 11 Both SP ana IoP in t he **" transfer routines,* 

11 00 SP in its transfer routine tut transfer is 
complete. 

00 11 IOP in its transfer routine out transfer is 
complete. 

^Transfer will oe restarted. The SP must set its send channel 
flao/ Iop»s receive channel flag according to the transfer 
di rect i on. 

lmposible D^AFL Combinations 

sp: oo oi io n 
Ion: lo li oo oi 
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8001 * 

8002 * THfc FOLLOWING ARE MODFLS FOR ROUTINES TO SHUTDOWN AND RESTART 
*<?J03 * THt TSB/G IOP, THEY ARE MERELY SKELETONS ILLUSTRATING THE 

-*004 * PROTOCOL. AND TIMING NEEDED TO COORDINATE WITH THE $P *S ROUTINES . 

}05 * RC IS THE SELECT CODE OF THE INTERCONNECT RECEIVE CHANNEL, 

0006 * SC IS THE SELECT CODE OF THE INTERCONNECT SEND CHANNEL. 

8007 * "- ■ " 

8008 #•+ *** 

0009 ** ** 

0010 "* P0WER«FAIL/P0WER-UP RECOVERY ROUTINE "# 

0011 ** ** 

0012 *■** *** 

8013 i " 

8014 * THIS ROUTINE PROVIDES AN ORDERLY SHUTDOWN OF THE I/O PROCESSOR 

8015 • WHEN POWER FAILS, WHEN POwFR RETURNS IT RESTORES ThE PROCESSOR 
8015 * TO AN EQUIVALENT STATE, RESTARTS THE INTERCONNECT lN~~COIi£ER~f WITH" 
8017 * THE SYSTEM PROCFSSOR, AND RESTARTS THOSE PERIPHERALS FOR WHICH 
801*3 * RECOVERY IS POSSIBLE, POWER FAILURES DURING A RECOVERY ABORT 

8019 * IT* THE POWER-UP PORTION IS RESTARTED AFRESH WHEN P OWE R "RETURNS 

8020 * AGAIN, 

8021 * 

8022 POW NOP 

8023 SFC 4 IS INTERRUPT FROM POWER-UP? 

8024 JMP POWUP YES 

8025 * 4, 

8026 ** SHUTDOWN THE I/O PROCESSOR *• 

8027 * * 

8028 OST P0WT1 TEMPORARILY SAVE 

8029 ERB,BLS (A) AND (B), 
030 SOC (E) AND CO) 

,031 INB REGISTERS 

8032 * 

8033 * CHpCK If INTERRUPT OCCURRED WHILE RECOVERING FROM A PREVIOUS 

8034 * POWER FAILURE, IF SO, THERE HAS BEEN NO SYSTEM ACTIVITY AND 

8035 * THE ORIGINAL SHUTDOWN STATUS IS STILL VALID WITH ONE POSSIBLE 
8035 * EXCEPTION, IF THf SP COMPLETED ITS RECOVERY BEFORE THE NEW 

8037 * FAILURE AND RETURNED TO ITS RFCLIVE DRIVFR, IT MIGhT HAVE SET 

8038 * THE lOPfS SEND CHANNFt FLAG. THIS CANNOT HAPPFN AS LONG AS 

8039 * POWHFal. THE FLAG'S VALUE WILL NOT OTHERWISE CHANGE, THE 

8040 * TOP DOES NOT RECORD ITS RECEIVE CHANNEL FLAG, TRUSTING THE " 

8041 * SP TO RESET TT CORRECTLY, 
80^2 • 

80^3 LDA POWpF FAILED FROM PQWER-UP ROUTINE 

8044 SLA BEFORE INTFRCONNECT RESTORED? 

8045 JMP P0WD3 YES, RETAIN PRFVIOUS STATUS 

8046 SZA NO, FROM OUT-OF-LINE RFCOVERY? 

8047 JMP POWDP YES, ChECK SEND CHANNEL ONLY 
80«8 IDA POw NO, COULD INTERRUPT 

8049 ADA P0WW1 BE FROM IN-LINE 

8050 SSA POWER-UP CODE? 

8051 JMP P0W01 NO 

8052 ADA POWRp YES 

8053 SSA IS IT? 

8054 JMP P0WD2 YES, CHECK SEND CHANNEL ONLY 
*055 * 

j056 * 

8057 * 

8fo58 * 

3059 * 4-39'* 



0060 


+ 










0061 


+ 


POWFR FAIL en DUPING NORMAL SYSTEM AC! I 


0062 


* 


RFCORD 


THE I/O 


PROCESSOR'S STATUS, 


0063 


* 










10064 


POwOl 


STB 


POWEO 


save 


0065 






OLD 


POWTi 


REGISTERS 


45066 






DS1 


POWAR 




0067 






LOA 


POW 


SAVF POWER-UP 


006« 






ST A 


POWRA 


RESTART ADDRESS 


0069 






1. 1 A 


1 


SAVE THE 


0070 






ST A 


POWSW 


SWITCH REGISTER 


0071 






LDB 


CLF0 


NOTE IF 


0072 






SFC 





INTERRUPT SYSTFM 


0073 






LOW 


STF0 


TO BE ON OR OFF 


0074 






5TB 


POWIS 


AFTER RECOVERY 


0075 


POWO? 


CLA 




SAVE THfc STATE 


0076 






SFC 


SC 


OF THE INTERCONNECT 


mil 






INA 




SEND CHANNEL FLAG 


0078 






STA 


POWFL 




0079 


* 










H0R0 


POWD3 


CLC 


A 


ENABl E INIFRRIIPT AND 


00«1 






Hl.T 


* 


WAIT FOR PnwER-UP 
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0001 

0002 

0003 

0004 
1005 
4^06 
0007 
8008 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
001/ 
0016 
0019 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
002/ 
0028 
0029 
0030 
3031 
0032 
0033 
0034 
0035 
0036 
0037 
0038 
0039 
0040 
00*1 

0042 
004 3 

00*4 
0045 
0046 
004/ 

0048 

0049 

0050 
0051 
0052 
0053 
0054 
0055 
0056 
005/ 
0058 
0059 



* 



/<t.S TORE STATUS AND RESTART I/O PROCESSOR ** 



POWUP CLA,INA 

STA POWFF 
STC A 
CLF RC 

THE SP REQUIRES 

APomn^up INTER 

CHANNEL FLAG. T 
ITS DMA*0N*1NTER 
SP WILL THEN WAI 
INTERCONNECT RES 
THEN THE SP IS N 
CRASHED)" AND THE 
(POST^SYSTEM SHU 



CLB 

INB,SZB,RS3 
JMP <« ? >> 

SFS RC 
JMP *«3 
LIB RC 
STB P0WT1 
OLD DMAT2 
RRR 15 
AND «7 
OTA SC 
STC SC,C 

THE. SP WATTS FOR 
IOP'S RECFIVE CH 
RESPONSIBLE FOR 
LEAVING It CLEAR 

LOB RChNA, i 

OTB RC 

STC RCfC 

LDB P0WT1 

BRS 

AR3 

XOR B 

SL6 

RAR,SLA 

CLA,RSS 

CCA 

STA POWT? 



NOTE INTERCONNECT STATUS NOT 

RESTORED IF RECOVERY ABORTED 
ENABLE POWER^FAIL INTERRUPT 
REAOY RECEIVE CHANNEL 
1>H l&i T j>T';A/l VfTZ 

A CERTAIN AMOUNT OF TIME TO SHUTDOWN, ENABLE 
RUPT, RESPOND TO IT, AND CLEAR ITSftEcOVF """ 
»E WAIT LOOP BELOW KEEPS THE 10P FROM SEN0tWs 
CONNECT STATUS UNTIL THE SP IS REAOV THE *%" 
T FOR'THE IOP«s RFsPONSE, sYNCHRONnTNG" BOfH ' 
TORATION ROUTINES. IF THE WAIT TIMES OUT, 
OT CURRENTLY TIME-SHARING (SHUTDOWN OR 

TOP SHOULD RESTORE ITSELF TO'THE TOTE — " - 
TDOWN) STATE, 

SP 'NOT THERE* 

TIME-OUT? 
YES, ACT AS TF «SSD» RECEIVED 
NO, WAIT FOR SP'S 

dma-on^intfrconnect STATUS 

SAVE 

IT 
MOVE LAST DMA DIRECTION BIT 

TO A(0) AND DMA ROUTINE FLAG 
(MODULO 4) TO A(2) AND A(j') 

inform sp of iop's 
dma-on-intfrconnect status 

the iop to restore the last word Sent on the 
annel (outside of a dma transfer). the sp is 
resetting the i.op»s receive channfl flag ott 

As DICTATED BY THE POWER-DOWN STATUS, 



RESTORE ThE I AST WORD SENT 
(OUTSIDE OF A DMA TRANSFER) 
AND CLP-AR THE RECEIVE FLAG 



REMOVE DMA 
DIRECTION 



BITS 



WAS IOP'S DMA ROUTINE FLAG ODD 
* SP IN OR BEFORE ITS ROUTINE? 

NO 

YES, NOTE DMA TRANSFFR 
TO BE RESTARTED 
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0060 
0061 
0062 
0063 
0064 
0065 
0066 
006/ 
0068 
0069 
0070 
0071 
0072 
0073 
H^7A 
0075 
0076 
Z^77 
0078 
0079 
0080 
0081 
0082 
0083 
0084 
0085 
0086 
0087 
0088 
0089 
0090 
0091 
0092 
0093 
0094 
0095 
0096 
0097 
0098 
0099 
0100 
0101 
0102 
0103 
0104 
0105 
0106 
0107 
0108 
0109 
0110 
0111 
0112 
0113 
0114 

011* 
0116 
0117 



* THE SP WILL RE-STORE THE SP SEND/lOP RECEIVE FLAGS EITHER AS AT 

* POWER-DOWN OR AS NEEDFD TO RtSTART A DMA TRANSFER. THEN IT 

* RESTORES THF LAST WORD SENT TO THF lOP'S SEND CHANNEL. THE TOP 

* MUST LEAVE ITS SEND CHANNEL FLAG SE? OR CLEAR if" AGAIN, AS 

* DICTATED Ry ITS POWER-DOWN STATUS. THE REMAINDER OF THE SP»S 

* RECOVERY ROUTINE TS LONG ENOUGH TO ENSURE THAT THE IOP HAS TIME 

* TO MAKE THIS DECISION BEFORE THE SP RESUMES TIMESHARING'.- 

LDA POWFl LOAD STATE OF SEND CHANNEL FLAG 

SFS'SC WAIT FOR 

JMP #«1 HANDSHAKE 

SLA WAS SEND FLAG CLEAR? 

JMP POWU1 NO 

LDB SCHNA,i YES, RESTORE 

0T8 SC THF LAST WORD SENT 

STC SC,C AND CLEAR THE FLAG 

CLC SC INHIBIT SEND CHANNEL INTERRUPTS 

IS/ POWFF NOTE INTERCONNECT RESTORED 



POWU1 



PERFORM DFVICF RECOVERY ROUTINES 



« APPROPRIATE CODE >> 



ISZ 

JMP 

< APPROPRI 

P0WIJ2CLA 

STA 

LDA 

OTA 

LDA 

CLO 

SLA, 

STO 

OLD 

POWIS NOP 

JMP 

* 

POWR1 ABS 
P0WR2 ABS 

POWFF OCT 



P0WT2 REPEAT DMA ON INTERCONNECT? 
P0WU2 NO 
ATE CODF> YES 

HACK 
POWFF IN-LINE 
POWSW RESTORE THE 
1 SWTTCH REGISTER 

POWEO RESTORE 

(E) 
ELA AND 

(0) 
POWAB RESTORE (A) AND (B) 

'STF 0' OR *CI.F 0' 
POWHA,I RESUME TIME-SHARING 

-POWUP 
POWtJP-POwRl 







POWTf 
P0WT2 
POWFL 
POwSw 
POWRA 
POWEO 
POWAB 

RCHNA 
SCHNA 
CLT8 



BSS 
EQU 
BSS 
BSS 
BSS 
BSS 
BSS 

DEF 
OFF 



STF0 STF 



2 

1 
t 
1 
1 
2 

RCHNO 
SCHNO 
■fH- 




«0 WHEN NOT TN POWER-UP ROUTINE 
«1 BEFORE INTERCONNECT RESTORED 
«2 DURING OUT-OF-LINE RECOVERY 



«1 IF SEND CHANNEL FLAG WAS SpT 

SAVES SWITCH REGISTER 

SAVES POWER-UP RESTART ADDRESS 

SAVES CE) AND (0) REGISTFRS 

SAVFS (A) AND (B) REGISTERS 

«> LAST WORD SENT ON RC 
■> LAST WORD SENT ON SC 



4-42 



3301 * * 

»002 ** interconnect dma routine *• 

B80 3 * * . 

8 39 4 * 

?035 * PERFORMS A DMA TRANSFER FROM (TO) THE SP TC (FROM) THE IOP. 

j006 * THE RECEIVE CHANNEL FLAG MUST BE CLEAR BEFORE ENTRY TCK ?HI# 

0007 * 'ROUTINE IF" THE TRANSFER IS FROM THE SP ( B(t5) "■ "l f. ' ~ 

3&08 * ON FNTRY CA) = TOTAL TRANSFFR LENGTH (POSITIVE WORDS) 

83«9 * (B)'« BUFFER MEMORY ADDRESS (BITS 14-0) AND 

3010 * "" """ TRANSFER DIRECTION <BIT~ IS *~1 I* FRON "SFT 

3311 . * IF A POWER-FAIL ABORTS A TRANSFER/ IT IS RESTARTED FRO*-; 

3012 * THE BEGINNING. :i •"■'•* 

3013 * " 

3014 DMAXR NOP 

3015 CMA,INA NEGATE TRANSFER LENGTH 
3015" DST DMAT1 SAVE FOR POWER-FAIL RESTART 
301/ IS/. DMAFl NOTE IN ROUTINE (DMAFL NOW ODD) 
.3 913 * 

38 19. * RFSTART AN INTERRUPTED TRANSFFR BY »DLD DMATl* AND 

8023 * JUMPING TO THE FOl LOWING LABEL, 

34021 * 

3022 QMXRS SZA,RSS ZERO«LENGTH TRANSFER? 

3023 JMP DMAX1 YES 

3924 5TC 3 NO, OUTPUT DMA 

0225 OTA 3 WORD COUNT 

3326 C.LC 3 OUTPUT DIRFCTION BIT 

B027 OTR 3 AND BUFFER ADDRESS 

4028 LDA DMACW ASK FOR »STC» ON EACH WORD 

3029 OTA 7 AND «CLC ON TERMINATION 

£030 STC 7,C START DMA 

9J1 SFS 7 WAIT FOR 

3032 JMP *-l COMPLETION cic =}> 

3Q33 DMAXi ISZ DMAFL ADVANCE ROUTINE FLAG TO EVEN 

2034 NOP (ROLLOVERS Do .OCCUR) 
.3035 JMP DMAxR,I 

3036 * 

0037 * DMAFL MUST FOLLOW DMAT2 FOR POWER-FAIL PURPOSES 

*038 * 

3039 DMAT1 BSS 2 SAVES TRANSFER LENGTH 

20«tf 0MAT2 EQU *-l SAVES BUFFER ADDRESS 

20** 1 DMAFL OCT ZERO WHENEVER SP SENDS »INl' 

30«2 DMACW AeS 12P0tf0B*WC 
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I OP 
CLF PC 



eQtteCrgB-lDteccQDDfict-BeslQceiiQO 

SP 
reaoy receive channel CLF ChI ready receive 



DLO DMAT2 
RRR 15 
AND =7 
CLR 

JMP »-b 
OTA SC 
OLC SC 
STC SC«C 
lNb«SZb»PSS 
<<time out>> 
SFS PC 



prepare 
i nterconnect 
DMA info 



sena it 

D^A_io£Q. 



wait for 

hdncshdKe 



DLD DMAT4 prepare 
RPR IS interconnect 
and .+r DMA info . 

SES CHI wait for 
jmr *-i handshake 



Lib Chi 



load lOP's info 



LIB PC 

STB PQWT I 
LDfl PChNA,I 
OTB PC 
STC PCtC 

LDH POwTl 



DMA info 



LDA PowFL 
SFS 9C 
JMP *-l 



SLA 



LDH SCMNA»I 

OTH SC 

STC SCfC 

JMP «+4 

CLC SC 



save SPLs info 
r es tore 
receive channel 



OTA ChZ send 

STC CH2.C DMA info 

SFS CmZ wait for 

jmh «-l hancisnaKe 



last sent word on rc CLtitHb cneCK for 



ChecK for 
DMA restart 



wait for 

hanashaKe 



DMA restart 
CLDh SCHNA«I restore} 
■COTh ChZ send > 
LSTC CnZ.C Channe I > 



CLC CmZ 

LDd PCHNAil restore 

OTb CHl receive 



channe I 



last-sent worn on.CHl STC Cm1,C 

ISZ PowFF note inter- 
connect restorea 
restore • 

sena . 

channel . 



4-44 



ISZ POWFF 



note interconnect 
restored 
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.2000 SYSTEM TABLES 
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I. DIRECTORY 



The Directory is a table which contains all necessary information 
about each program or file in the system I ibrary • It resides on 
the disc ana may occupy from X to 60 tracks* depending upon how 
many discs there are specified (maximum is 10 per disc) by the 
operator at load time. A core resident table called DIREC 
contains information on the directory itself. 

Each directory track occupies 3d contiguous blocks. A directory 
entry consists of Ik words. The entry format is detailed on the 
following page. The Directory entries are kept sorted on words 
0-3. bit 15 of words 1 through 3 are not considered In the 
sorting. Names of fewer than 6 characters are filled out with 
spaces. The last reference date is the most recent date on which 
the program or file was referred to* while the last change date 
is the most recent aate on which it was altered. The directory 
contains two pseudo entries which are the first and last entries 
in the table. 
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DIRECTORY 

ENTRY 

FORMAT 

NORMAL ENTRY 
F-irst Entry Last Entry WORD CONTENT 

0-10 USER ID 
0-11 PROGRAM BIT lb s 1 IF AN 

ASCII FILE 

-1 a OR FILE = 1 IF A FILE, 

IF A 
PROGRAM 
0-13 NAME = 1 IF SEMI- 

COMPlLEDf 
IF UNCOM- 
PILED 
-1 A PROGRAMS - START OF PROGRAM POINTER/ 

FILES - RECORD SIZE 
5 LAST REFERENCE DATE (YEAR - 6ITS 

15:9» DAY - HITS 8:0) 
-1 -1 to LAST CHANGE DATE (HOUR OF THE YEAR) 

7 PROGRAM STATUS 

bIT 

lb DEVICE/FILE SUPPORTS INPUT 
1^ DEVICE/FILE SUPPORTS OUTPUT 
13 PROGRAM/FILE HAS PFA 
id FILE HAS MWA ACCESS 
11 PROGRAM/FILE'S OWNER HAS FCP 
10 UNUSED 
* UNUSED 
8 UNUSED 
/ UNUSED 
6 UNUSED 
b UNUSED 
<♦ UNUSEU 
J PRIVATE 
d LOCKED 
1 PROTECTED 
UNRESTRICTED 
-1 -1 8 DISC ADDRESS IF =1 INDICATES NON- 

SHAREABLE 
DEVICE 
OR 
9 DISC FILE/PROGRAM DEVICE OESIG- 

NATOK* 3 b-BIT 
FIELDS 
- 10 USED ONLD bY ThE LOADER 

11 LENGTH (-WORDS FOR POROGRAMt 

♦ RECORDS FOR F ILE) 
(0 FOR NON-SHARE AbLE DEVICE) 
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II. DIREC 

DIREC is a 560 word memory resident table which contains 
information about the directory. DIREC entries consist 
of the first four words of the first entry on each of the 
directory tracks* as well as the track disc addresses and 
lengths. This facilitates rapid location of directory 
track entries by system programs using a method which is similar 
in concept to the use of the words at the top of dictionary 
pages. 

The DIREC Taole has the following structure: 

DIREC ♦ -length In words of first directory track 

1-4 same as first four words of first directory 

track 
5-6 disc address of first directory track 
7-13 same as 0-6 out applied to 2no directory track 



553-559 same as 0-6 put applied to 80th directory track 

A disc address of implies that there is no such directory 
track. when word is 0* words 1-4 ar& meaningless. 

when generating a system or reloading from mag tape* the system 
operator has the opportunity to specify the number of directory 
tracks per disc* in the range of 1-10* which is saved in NDIRT. 
The total number of directory tracks is this number times the 
number of discs on the system. Each directory track may contain 
as many as 8184 words s 682 directory entries. 
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III. ID TABLt 



The ID table (IOT) is a disc resident table of from 1 to 10 

tracks which contains one 12-word entry for each ID coae on the 

system. The entries ere kept sorted according to the ID codes. 
An entry has the following format: 

WORD CONTENT 

USER ID 

1 PASSWORD (FlLLtD 

2 WITH CMS If FEWER 

3 THAN SIX CHARACTERS) 

4 TIME ALLOWED (IN MINUTES) 

5 TIME USED (IN MINUTES) 

6 DISC SPACE ALLOWED (IN BLOCKS) 

7 DISC SPACE USED (IN BLOCKS) 

8 USER CAPABILITIES - IF THE BIT IS SET, THE USER HAS THE 
CAPABILITY 

BIT MEANING IF SET 

15 UNUSED 

14 up - kEADER PUNCH 

13 JT - JOB TRANSMITTER 

12 JL - JOB LINE PRINTER 

11 JP - JOB PUNCH 

10 JI - JOB INQUIRY 

9 JM - JOB MESSAGE 

b MT - MAGNETIC TAPE UNIT 

7 pp - PAPEk TAPE PUNCH 

6 PR - PAPER TAPE READER 

5 LP - LINE PRINTER 

4 Ck - CARD READER 

3 UNUSED 

2 PFA - PROGRAM/FILE ACCESS 

1 FCP - FILE CREATE/PURGE 

MWA - MULTI WRITE ACCESS 
9-10 UNUSED 



IV. IDEC TABLE 



IDEC is a 40 wora memory resident table which contains 
information about the io table* There is one 4-word entry for 
each id track ana each entry has the following format: 



word 

FIRST ID ON THE TRACK 

1 DISC ADDkESS 

2 OF THE TRACK 

3 LENGTH IN -WORDS 
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ID FORMAT 



BIT lb 14 



10 9 



NOT 



USED 



IDENT CHARACTER 



IDENTIFICATION NUMERAL 



ASCII EQUIVALENT - 1008 



RANGE FROM TO 999 
OR TO 1747B 



EXAMPLE! M100 a 32144B 



0110 1 0001100100 



15b 



14<*B 



15B ♦ 100B s 115 : ASCII "M»» 
0144B = 100 

10 
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The Swap Areas Table (SAT) is a disc resiaent table of 64 woras 
long which contains 32 two-word entries? one for each swap track 
on the system. The Ufa entry is the disc address of the itb swap 
track. A zero entry indicates the absence of that swap track. 

This table is built, used ana updated by the Loader only. 

V. AUI 

The available disc table (ADT) is a disc resiaent table which 
contains one three-wora entry for each area of the disc which is 
unallocated, fcach ADT tracn occupies 3d contiguous blocks* An 
entry has the following form: 

WORD di sc 

1 address 

2 length of area in blocks 

There is one ADT track for each disc on the system and only 
entries for one Particular disc appear on a track. The first 4 
blocks of each disc are used by the system ana are therefore 
always unavailable. Thus* there are no contiguous areas which 
over I ep di scs • 

The 24-wora available disc table aaaress table (AdTAT) in the EQT 
table refers to ADT in the followina format: 

wo«D 0-1 disc aaaress of first tracn 

2 length of first track in - words 



21-22 aisc aaaress of the dth tracK 
23 length of the ttth track 



VI. LQX&£U-BLQC&S..I&bL£ 

The Lockea Blocks Table is a ai sc-res i aent table which resides in 
the 2b6 woras of block 3 of ejoch aisc. It contains oine two-word 
entry for each area of the aisc that has been MLOCKED. An entry 
has the following format: 
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WORD disc adaress relative to this disc 
1 length of area in blocks 

The rest of the table is a zero filled* 

The disc address is stored as If the disc were logical disc 0. 
The Locked Blocks Table is cleared only when it is determined 
during the loading procedure that the disc does not have a 
val id TSo label ana the operator requests that one be written. 
This means that the packs "remember" which blocks are unavailable 
even if a different 2000 system is loaded. 



VII. EUSS.IA.oLfc 

The FUSS table is a 1024 word disc resident table. It is divided 
into 32 sections of 32 words each. The 32 words in each section 
are the two word disc address of the 16 possible files currently 
being accessed by the user corresponding to that section. 
Addresses of indicate no file or a non-disc ASCII file entry. 
The high word of the disc address may have one or two of the high 
bits set indicating: 

bi t mean ing if set 

15 file is read-only to this user 

14 file was locked by this user 

13 wR restriction was imposed by this user 

12 Rft restriction was imposed by this user 

If pits 13 and 12 are not sett an NR restriction was imposed by 
the user. The FUSS table is written to the disc in two halves 
by the LOADER. It must occupy two contiguous disc blocks. 

The reasons for maintaining the FUSS table are; 

(1) To prevent simultaneous write-access by two or more users 
unless the file has Mwa and no user has specified WR or RR on the 
f i le. 

(2) To allow co-operating users of a file exclusive use of a 
file via the LOCK and UNLOCK statements. 

(3) To oevent moving or removing an active file in the routines 
PURGE and MLOCK. No check is made for the routinesa COPY and 
BESTOW. 

A user's FUSS (i.e. his section of the FUSS table) Is set by 
the FILES routine* which is called from BASIC at the statement. 
Individual entries in a user's FUSS are changed by the execution 
of ASSIGN statements. Tne user's FUSS is cleared by HELLO* BYE* 
and normal or abnormal program termination. 
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FUSS TABLE 



FUSS +0 :dlsc address of file In: > 

♦1 : use by port 1 : >. -UP to lb files per port 



+ 2 :disc address of file ins > 
+3 : use oy port 1 : > 



+ 4 



♦ 32 

♦ 33 

♦ 34 




♦30 jdisc aaaress of file in: > 
+31 : use by Port 1 : > 



: d i s c 

: use 



aaaress 
by Port 



of 



file in: < 



-Zero fill indicates no 
f i le 



Bit 15 of first word 
indicates Read-only 

access (=1 ) or 
Read/write (=0) 



FUSS 



bSS 32 


Port 


Entr i es 


> 






bSS 32 


Port 


1 Entr les 


> 






bSS 32 


Port 


2 Entr i es 


> 




> 


• 






y 


SECTION 


> 


• 






> 


ONE 


> 


• 






> 




> 


fcSS 32 


Port 


lb Entr ies 


> 




> 


BSS 32 


Port 


lb Entr I es 






> 


• 






> 


SECTION 


> 


• 






> 


TWO 


> 


• 






> 




> 


BSS 32 


Port 


31 Entries 


> 

> 




> 



initial i zed to 
zeroes and disc 
space reserved 
just prior to 
I Ibrary being 
*r i tten on di sc 
on disc to ensure 
sections one and 
two are written on- 
to contiguous disc 
sector s—w ill be 
read into user area 
during later system 
usage. 



- unprotected files storea unaer system 
or broup lD»s will be accessed as read- 
only by other ID*s» 
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VIII. COMTABLL 

The COMTAbLE is a list of all user and system commands con- 
taining their ASCII codings and disc locations or core addresses* 
The structure of the COMTABLE is as follows: 



C0M1 
COM2 
COM3 
COM4 
C0M5 
COMb 



cooes for commands which are 

executed immediately by the 

system 

codes for commands which are 

executea by 

BASIC 

user commands wn I ch are 

executea by disc resident 

programs 

system commands —all are 

executea by disc resident 

programs 

starting addresses for those 

commands which are listed 

under COMl AND 

di sc addresses 

commands which 

under COM3 and 



COM* 

for those 

are I i sted 

COM4 



< thi s sect ion 
f I I led by the 
loader) 



is 



Since each command is recognized only oy its first 3 letters* the 
scanner converts each letter into a number from to 31(d)* and 
then packs the three codes into one word as three b-oit bytes. 
In addition* bit lb is set for system commands. Codes of -I in 
tions di 3* and * do not correspond to any possible 3-ietter 
coae. Their purpose is to generate room in C0M6 for disc 
addresses of routines that are called indirectly* or for tables 
I ike FUSS. 
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COMMAND 

WORD 

FORMAT 



lb 14 10 9 5 4 

: bYTfc ONE bYTE TWO bYTE THREE I 



first 3 
bytes of 

command 

name i cent i f y 

the command 



set if command must be from 
system console. 

BYTE = ASCII CHARACTER VALUE - 
101b 



COMMAND 
TABLE F-ORMAT 



Program 
COMl 



COM2 

COM3 
COM4 
COMb 



Name 



Descr ipt i on of 
Iefeie.CoDleols 

Part I - SECTION 



I- 



- SECTION II- 



- SECTION III- 



HAH7 II 



core resident user 
commands* executed 
immed i ate ly • 
core resident user 
commands* need user 
program in core be- 
fore execution can 
proceed. 

disc resident commands 
—user commands 
— system console commands 

core starting addresses 
for PART I» SECTIONS I 
k II* d word disc 
addresses for a I I 
disc resident commands* 
and error messages. 
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8SYSTEM LIBRARY 



C0eE~&£SIQ£UJ.USbe.&QtibA6iQ. 
EaECUIEQ.IWttfcQIAlfclY. 

SCRATCH SCR 

TAPE TAP 

KEY KEY 

CQeE.feESlQE&I.USfcb-iiOMtSA&QS 

^EEQ-USEB-eB0faB6M.JW.C0BE.BEE0BE 

EXECUIlQN-CACrf.BaQCEfcQ 

RUN RUN 

LIST LIS 

PUNCH PUN 

LOAD LOA 
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SYSTEM LIBRARY 



DISCbtSIQtbl 
SXSIfc.fc-C0MM6blQS-tBQM.USEB-C0WS0LE 



DUMP 


DUM 


DIRECTORY 


OIR 


REPORT 


REP 


STATUS 


STA 



DISCbESIQE&I 
SY^Itfc-CQbUA&QS-tfcQfc.SSSIttf-CQblSOLE 



ANNOUNCE 


ANN 


REPORT 


REP 


RESET 


RES 


CHANGE 


CHA 


DIRECTORY 


OIR 


STATUS 


STA 


SLEEP 


SLE 


HlbERNATt 


Hlb 


NEW ID 


NEW 


K1LLID 


KIL 


MUNLOCK 


MUN 


MLOCK 


MLO 


COPY 


COP 


CESTOW 


6E"S 


PURGE 


PUR 


ROSTER 


ROS 


PHONES 


PHO 


bREAK 


riRE 


DEVICE 


DEV 


ASSIGN 


ASS 


RJE 


RJE 


DUMP 


DUM 


DISCONNECT 


D1S 


bANNER 


BAN 


AWAKE 


AWA 
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SYSTEM LIBRARY: 



DXSCfcs&SlQEUI.US&B-CQfcJUAUQS 



SAVE 


SAV 


CSAVE 


CSA 


GET 


GET 


APPEND 


APP 


HELLO 


HEL 


BYE 


BYE 


PUPGE 


PUR 


RENUMBER 


REN 


NAME 


NAM 


CATALOG 


CAT 


LIBRARY 


LIB 


GROUP 


GRO 


DELETE 


DEL 


TIME 


TIM 


LENGTH 


LEN 


ECHO 


ECH 


MESSAGE 


MES 


EXECUTE 


EXE 


DEVICE 


OEV 


UNRESTRICT 


UNR 


PROTECT 


PRO 


LOCK 


LOG 


PRIVATE 


PR I 


StoA 


SWA 


MWA 


MWA 


PAUSE 


PAU 


CKEATE 


CRE 
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SYSTEM LIBRARY 



QlaEy-UiSC-BESIQfcbl-dLQCKS 

\> ILES PROCESSOR 
ASSIGN STATEMENT PROCESSOR 
SYSTEM STATEMENT PROCESSOR 
LOCK/UNLOCK STATEMENT PROCESSOR 

SAVE OVEHLAY 

STATUS (USER CONSOLE) OVERLAY 

STATUS (SYSTEM CONSOLE) OVERLAY 

MLOCK OVERLAY 

DUMP OVERLAY 

LENGTH TAdLE 

FUSS TABLE - d. PAkTS 

ERROR MESSAGE TABLES 

TAPE MODE CLEANUP 
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IX. LOGGR 

LOGGR is a 64-word queue which contains cooes for print I ng 
LOGON/OFF messages. Entries are placed on the queue by HELLO* 
BYE* and SLEEP. Each entry consists of 2 words* with the 
following format: 

WORD 0: user id (bIT lb=sp for ON* i for OFF) 
■1 : bits 15-b s 60 x hrs ♦ m|ns 
bits 4-0 s terminal number 

The representation of a user id is as follows: 



BITS 14-10 s letter <a =l f B =<** ...» Z = 32(8)) 
BITS 9-0 s (0-999) 

The fol lowing variables are relevant: 

LOGCT as # of unprocessed entries in LOGGR 

LOGR1 = points to word 1 of last Processed entry 

L0GR2 = points to word 1 of last unprocessed entry 

Note that LOGCT s <=> LOGRl=LOGPii 



4-61 



S.--IELLlY.fc>t_IABL£. 

This set of 32 tables* one for each user» contains relevant 
information about the various terminals. The structure of the 
tab les is as f o I lows : 



Wora 




wora 

Nflmg 

?FLAO 

?TNUM 

?DISC 

?PROO 



b 


?1D 


6 


?NAMt 


7 




10 




11 


7TIP.E 


12 




13 


?CL0C 


14 


7RSTR 


15 


?STAT 


16 


7LINK 


17 


7PLEV 



20 


70REC 


21 


70UTP 


23 


?NRfcC 


2h 


?PkIU 


as 


7RTIM 



UeSCClBliQD 
User bit flags 

Port numoer in bits Id to b 

Aaaress of Swap area on aisc of program 
(2 words) 

Points to last used address of Program 
wnen in core 

User ID (=0 if no current user J 

> b character (or less) 

> program 

> name 

> Starting time (set to DATIM and 

> DATlM+1 at LOGON) 

user's RUN time time-out cIock 

nestart aadress for suspended programs 

user status 

Points to ?L1NK of next port on Queue 

Priority of user on Queue 

If user not in the Queue* contains 

program type (temporary storage of 

?STaT) 

Record size of 0UT= file 

Logical unit number or disc address of 
OUT= file 

Numper of records in 0UT= file 

Owner ID of program in swap area 

Response time for ENTER 
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26 
27 
30 



?TEMP > Temporaries 

> used, by 

> Library routines 



?FLAG till DEFINITIONS 



Bit 




uuobec 


Naojfi 





TERR 


1 


CFLAG 


2 


HFLAG 


3 


TAPEF 


A 


UNABT 



UfiSCCiBJtiQQ 

Error detected on tape input by user 

Program in swap area is compiled 

HELLO is runninq 

User is in tape mode 

Unable to abort user when set 



Is set - when compilation is occur ing 

- when compiler executes a disc routine 
(al lows port a chance to aoort just 
prior to running of disc routine) 

- FILES 

- CHAIN 

- ASSIGN 

- when Update Last Reference Date for files 
is being run 

Is not set* put similar effect (i.e.* unable to 
abort) when Library routines are running - except 

- LIBRARY 

- CATALOG 

- GROUP 
from i - DIRECTORY 
user 1 - REPORT 

console -t - STATUS 

OUTwT user output buffer full-output wait 

PACT Port needs to be processed by scheduler 

ABTRY Abort attempt that has been delayed due to 

UNABT or should just be flagged due to PBFLG 



4-63 



B 


UFCMK 


9 


CHNFG 


10 


SPACu 


11 


MfaUST 


IP 


PBFLG 


13 


CBFLO 


14 


OUT=P 


15 


TKLRW 



Dirty files flag-used for last change 

Chain is running-Inhibit certain activities 

List has allocated an output duffer for the 
user 

useo to flag disc transfer errors 

bkK function disabled the break Key capability 

System operator enabled the DreaK key 

The command running has an 0UT= file 

Transmission error on port 
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?Tnum: Teletype number In bits 12-b? usea for sending in- 
formation to the I/O processor. 

?DISC! Disc aodress of user's swap area 

?PROG: When user is on the disc PROG points to the last 
core location used by the program* when the user 
is loaded into core* PROG is placed into PBPTR. 
When he is written back to disc* PdPTR is copied 
into PROG. BASIC is required to maintain P6PTR as 
a bouna on the core it is using. 

?ID: user's id, o if none. 

?NAME: A three word entry containing the user's pogram 

name. It is set by the routine NAME & GET & CHAIN, 
and cleared by HELLO. When fewer than 6 characters 
are in the name* blanks are appended. Each word of 
the entry contains a flag in bit lb. Meaning of the 
flags* if set, are : (1) program locKed (2) program 
private or (3) program protected 

7CL0LJ This is the time' out clocK used to determine the 

length of a user's time si ice. See the discussion 
on scheduling for further information. 

?RSTN: This is set* when a user is Placed on the queue* to 
his starting address in core. When the user I s 
actually initiated* RSTR is set to 0. whenever 
RSTR s 0* the transfer address of the user can be 
found in location PREG. 

?STAT: indicates user's status. The user's status Is as 
fol I ows : 



Numer i c 




BfiCCfiSfiDtaliQQ 


t^aajfi 


-4 


%PUN 


-3 


%ENTo 


-2 


S.U1SC 


-1 


%Ab0RT 





MOLE 



QfiSCCieliQQ- 

Port is unavailable due to hardware 
f ai lure. 

An ENTER statement has timed out 

Disconnect this user. 

User wants to ABORT 

Idle - no user* or waiting for 
commanas or syntax 
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1 fcPAUS Waiting for device attention or PAUSE 

command timeout 

2 %INPT waiting for input from user 

3 %OUTw waiting for outout to user to complete 

4 feSYNT Processing user syntax or C FILES 

-C CHAIN 
■C library 
•C ASSIGN 
C SAVE 
«C CSAVE 

< LOCK/ 

< UNLOCK 
•C SYSTEM 
•C BYE 

< CREATE 
•C PURGE 

£5 Processing a command - value will 

correspond to command table entriest 
e.g. » 

5 =5 RUN 
b = LIST 
7 = PUNCH 
etc. 
?LINk: The LINK *oras in the tables are used to form a 

aueue of active users. AM users whose status is 

*4 are in the Queue. 

See discussion on scheduling for further 

i nf or mat ion. 

?PLEV: This woro gives the priority level of the user when 
the user is on the queue. when the user's status is 
set to d or 3« the previous value of ?STAT is copied 
into ?PLLVt and the user is removed from the queue. 
The possible values of ?PLEV are: 

sgl_b*-«QuXioe-Ceiiiog-Scbeaulec 

uwmecical-kolwt . Desccictloo . - 



Syntax processing 
Return from input or output wait 
Return from ENTER time out 
when COMliI commands (?PLEV=e:) reach the 
head of the queue 
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OPEN command when it reacnes head of Queue 

(from ?PLEV=*) 
Core resident program to update Last 

Change Date for files 
When compiler calls a disc resident 

programt the running of which causes 
the user ?CLOC to be incremented by one 
FILES 
CHAIN 
ASSIGN 

1 COMII Commands - NUN 

LIST 

PUNCH 

XPUNCH 

2 COMMIII Commands 

4 compute bound programs* when time-slice 

, has been exhausted 

OPEN command after each group of 4g0 
blocks has been initialized 

Takes on value of ?STAT during input/outDut waitt ENTER wait* 
or wnen program to update Files Change Date is running. 

IcfiosfoccDatxQO-Qt.tciQCit^-at.tiojfi.Qf.Eotficiog-Scbedulfic 

NP a EP * NPOKT/4 

NP s new pr i or i ty 

EP = entering priority 

NPOkT = -(number of ports logged on +1) 



?OPEC: Logical record size for the ASCII outs file. 
Bit ib=U if the file is on disc. 

?OUTP: Either (a) logical unit number of the 0UT= file, if 
a non-shareable device or (b) two word disc address 
if the our= file is on disc. 

?NPEC: Number of records in the 0UT= file if disc file. 

?PRIU: ID of the owner of the program in the user's swap 
area m bit 15 = 1 if user has FCP capability. 

?fcTIM: The length of the time in seconds tnat it took a 
user to resoQnd to an <ENTER STATEMENT>. 

?TEmP: Used (along with ?f<TIM) to save var laoles when 
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OPE.N» CMlALOGt GKOUP» LIBRARY* STATUS* DIRECTORY* 
ana RERGkT are swapped out. 

Associated with each item in these tables is a symbol which is 
EQuatea to the corresponding number ol* the item. For example: 

?FLAG EQU 
?TNUM tuU 1 
?TEMP LuU dlb 

These symbols are Primarily used for adjusting pointers to the 
table. For example* if the 6 register contains a pointer to the 
LINK entry of some user» the instruction 

AUB .+?ID-?LINK 
will point B to his ID entry. 

• is a symbol locateo in base page at the entry of a table of 
constrants from -2b to ♦51. A word containing the value N* where 
-28*N<bl can be referenced by •+N. 



4-68 



xi. £uuieefc&i-ia6Lfc 

The eauipment table (EuT) is the area of memory which describes 

the resources available to the system. It resides in locations 

100 - 17b as fol lows: 



100 

101 
102-131 
132-141 



1*2-143 

144 
145-151 

152 



153 



NIDT 
NDIkT 
ADTAT 
DKTbL 



DADSL 
DLNSL 
SYSID 
MAGSC 

NPORT 



154 


YEAk 


155-156 


DATIM 


157 


hDATE 


160 


SLEPT 



number of ID tracKs 

number of directory tracks per 

ADT address table 

There is one word in this area 

h discs* when the woro is zero 

oisc does not exist, otherwise 

contain the high priority selec 

the unit number. 

aisc address of system library 

length of system library in +■ o 

A ten-character system identlfi 

nigh oriority select code for m 

is set if console is a terminet 

Two»s complement of the number 

system. The ports available ar 

-NPOkT -1. 

Year of the century 

Time of year. The first *ord I 

the year* and the secono is the 

ms units in the hour minus 3b00 

hour of year that the system wa 

hibernated. 

says that the system has oeen 

it has not. This word is moaif 

sleep and reload Procedures and 

the system may not be reloaded 

has not teen, slept. 



di sc 

for each of the 
• the particular 



bits 

code 



lb:a 
and 7:0 



locks 
cat i on. 
ag tape. 



bit 15 



of ports on the 
e numbers thru 



s the hour 
number of 
0. 
s last 



of 
100 



s I eot • -1 that 
ied only by the 

insures that 
from disc if it 



Following the eauipment table* in locations 161-176 are another 
set of words which must correspond with the loader. They are 
defined as follows: 

lbl core address' in the loaaer of the final disc 

bootstrap. 
ltd Core address of the first loader segment in 

the Master Segment Table <MST). 
163 EkXDX Pointer to salvage portion of MST 
16^ mhad Core address of the Moving head Oisc Table 

(MhTdD 
16b GMQ6P Core address of the routine to get a buffer 

for disc error messages. 
16b D1SCA core address of disc driver entry point. 
167 DISCb Core address of disc ariver interrupt entry 

po i nt . 
170 MrtUSY Disc driver busy flag. 
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171 MwnPD word count for di sc driver. 

172 OPEDP core address of aisc driver auto restart entry 

point (used by oo*erfai l/auto restart routine). 
173-17^ EGTAD Disc address of the Equipment Table 
175-176 Disc aadress of the 1DEC Table. 
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"XII. fc)ASI£e-5tliWtbI„l4dLE 

The Master Segment Table (MST) is a 6b-word taole resident in 
the loader. It is the first portion of the bootstrap and is 
pointed to by the first word of the Equipment Table. The first 
word of the table contains - the number of system segments. Each 
group of 4 words following the first word has the following 
format : 

wo«D 1 length of segment in -words 

2 absolute* beginning core address of the segment 
3-4 disc address of the segment 

There are 16 segments* oraerea as follows: 

SEGMENT 1 interrupt locations (2(ti) "to" 30(b)) 

2 System case page (end of EUT "to" 1777(8)) 

3 System linkage area (4005(b) "to" 4017(b)) 

4 Disc Error Recovery area (25000(b) to (25777(b)) 

5 System segment 1 (end of DIRECT "to" ^1777(8)) 

6 System segment 2 (42000(d) "to" 51777(b)) 

7 System segment 3 (52000(b) "to" 61777(8)) 

8 System segment 4 (b^ooo(d) "to" 71777(b)) 

9 System segment 3 (72000(b) "to" 77677(b)) 

10 Equipment Table (100(b) "to" 176(b)) 

11 Direct Taole (30<t0l(b) "to" 31530(b)) 

13 Loader segment 2 (15500(b) to 23777(b)) 

14 Loaoer segment 1 (2000(b) "to" 14567(b)) 

15 Cold Dumo Segment (<^00U(b) "to" 24765(8)) 

16 Disc qriver (2b000(a) "to" 27677(b)) 

Note that this incluaes all core resident portions of the loader 
and system except for locations 14.500(b) "to" 15777(b). The 
first 1000(8) of these words comprise the disc bootstrap and are 
resident on biocxs 1 ana <z of each disc. Locations 15500(8) "to" 
15577(b) may only be usea for temporaries. 



4-71 



aiii. uut&io 

MUERTn* as the name suggests* is a table of all system halts. 
All of the system halts can be referenced by tne label "DEATH". 
MUERTn explains the meaning of each halt ana gives an indication 
of possible recovery or failure. The following is a copy of the 
tab! e: 

d - Erroneous* non-recoverable system transfer has 

occurrea, 
5 - A parity error nas occurred* checK the hardware, 
lib - unexpected interrupt from the processor interconnect* 

take a cola dump of this unrecoverable system. 
30h - Disc driver is busy. Recovery not posslole. 
31h - Disc called is not pesent. no way to recover. 
3dB — Unable to read disc recovery routines into core. No 

way to recover. 
34b - Disc error causing the system tables to be 

incompatible. Recovery is out of the question. 
3bb - Powerfail nas occurred* check restart switch position, 
37p - bad ADT aisc address generatea. Recovery - no way. 
4UH - impossible condition occured. no way to recover. 
42H - Owner of a otrectory entry is not in the IDT. No 

recovery. . 
448 - IOR askea for non-existent PvTE command,, no recovery. 
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*iv. bjoyiuG-btaU-UISCi^oLt 

WOKO 0-1 Two-word absolute sector number of the 

first 128-word hardware sector on logical disc 

2 Points to select code/unit number in DKTBL for 
locical disc 

3 number of sectors/cylinder 

4 number of sector s/tracK 

5 Current cylinder position of heads for logical 
disc (used only for 7900 discs) 

6-11 Same as 0-5 applied to logical disc 1 



42-47 Same as 0-5 applied to logical disc 7 

Note that the address in the first two words of each section of 
the table is a sector address and mMst be divided by two to 
obtain the blocK aaaress, The last entry is followed by a 
truncated ninth entry, MAXSC* which always contains a double 
integer specifying the first absolute sector numoer which does 
rfffk exist. The actual numbers for the 3 kinds of aises used on 
ACCESS ore as follows: 



WORDS 1-2 



2fafc3 



93380(10) 

186760(10) 

2801*0(10) 

373520(10) 

466900(10) 

560*80(10) 

653660(10) 

*6Q (10) 

24(10) 



Z2UQ 



19488(10) 

3d97b(10) 

58464(10!) 

7/932(10) 

9f440(10|) 

116928(10) 

I3641o(10) 

9e(10) 

48(10) 



Z*Q5 



59184(10) 
118368(10) 
177552(10) 
236736(10) 
295920(10) 
355104(10) 
41^288(10) 
144(10) 
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DEVICE TABLE INITIALIZATION 

The Non-shareable Device Table is a table of 321 words consisting 
of the number of non-snar eab I e devices ana a five word entry for 
each device. The I/O Processsor Configurator builds this table 
from the information supplied by the system operator. 

The table can contain up to 64 entries. bach entry is 
internally referencea by a logical unit number through 63. 
The table appears as follows: 



Dv/lbL 



u of non-shareable 
devices (negative) 



entry for logical 
unit 



one wora 



f I ve wor as 



entry for logical I five words 
unit l j 



entry for last 
logi ca I un i t 



f i ve words 



During system inital izat ion. the loader program will send the IOP 
a pre-emptory request with send device table -suD-code, Tne IOP 
will respond with the device table* oreceaea by the number of 
ports configured ana tne number of non-shareable devices 
specified. The entries in the table have the following fields: 



w 



WORD . CONTtNT 
device 

oes i gnator 



DESCRIPTION 
Tne designator is composed of two 
letters ana one or two digits, 
octal 101 Is subtracted from the ASCII 
value of each letter, allowing codsng 
of the designator as 3 five-bit fields 
in bits 14-u. The numoer » which is be- 
tween 1 and 31. is not coded. 



select code 



Bits /-0 contain the select code of the 
device. Bit IB is 1 if the device 
supports input* bit 14 is 1 if it 
supports outout, bit 13 is set if the de- 
vice user is trapping errors and an error 
occured on his last use of this device, 
bit id is 1 if it supports CTL functions 
but not output. If Pit Id is set, so is 
bi t !<♦• 
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2 Maximum record The maximum record size that can be 

size requested when using the device. 

3 assignment This entry can have one of the following 

values: 

idcode - only users with this I dcode 
can have access 
1 - device reserved 

for RJE 
. — all users can 
have access 
-1 - no user can have 
access 

4 tty table If 0» the device is not busy; if l* 

in use by RJES otherwise it points to the 
?FLAG entry of the controlling user* 

The contents of the device table can be displayed by use of the 
DfcVICE command. 
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SUPPLEMkNTAkY NOTES ON bASIC 
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October 11, 1976 *ldt> PM 



I. SYNTAX 



The general process of analyzinq an input to the l an- 
uage processor is displayed in the flow charts. 
The annotations in the listinq explain the actions 
of the subroutines* whj le the core map and sections 
on internal representation describe the objects/ 
structures being created or manipulated. The BASIC 
syntax, in conjunction with the listing, exoiains the 
method of i cent i f icat i on and recognition of legitimate 
BASIC statements from the input string. 



II. PHAbt 2 



a. compi I at ion 

The preliminary section of CmPLE prepares for execution 
of the program following a successful compilation. Null 
programs require no processinq. If a sequence number 
follows the PUN (e.q.» nuN - d'dU) the i nterpreter i s pro- 
gram counter is set to the first statement whose seouence 
number eauals or exceeds the reference, otherwise it Is 
set to the first statement of the user program. if the 
common oree has not been allocated, aLCOM is called to 
compute the space needed ano move the program accord- 
ingly. Common is initial izea to -51c:, If the program 
is sem i-comp i I eo <SPTP=0, SYMTBOO) we may skip building 
the symbol table. otherwise FILTfo is set to so PPNST 
will not terminate compilation by mistaking it: for decom- 
p i I at ion. 

The symbol table is then built as explained in the 
listing (pefer to the flow chart for general Iodic flow 
ano to BASIC variable Storage Allocation fr a visual 
example). Also, at this time statement number references 
are replaced by absolute aodresses. This is facilitated 
by dividing the Program into 3d parts ano buildinq a 6<* 
woro table in fckSEC (an unused storage BIock in the user 
urea on base page) containing the first statement number 
and aodress of each Part. During compilation SPTR points 
to the program word belnq processed. Pointers to <FILES 
statements> sire stored in FLSTS and a count of them is 
Kept in FILC7. An error in compilation will cause a call 
to UCMPL to restore the source form of the program fol- 
lowed by a call to the error routine, if after a success- 
ful compilation at least one <FlLtS statements has been 
found, BASIC calls the system to build the file control 
piocks, filling all but the fifth, sixth, ninth, tenth* 
fifteenth, ana seventeenth words of each entry. 
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The symbol routine has two entry points: SSYMT used for 
functions ana simple variables* and ASYMT for array and 
string variables. Because the dimensionality of an array 
variable may not be Known locally (e.g. MAT A=B) some 
symbols may. have t*o entries. If this is the case* the 
••don't know" entry will always be farther down In the 
table (i.e.* have a higher core address) than its dimen- 
sioned counterpart. 

B. VALUE 

VALUE is responsible for detecting aef .ici encies in the 
symbol table* allocating storage for the values of sym- 
bols initializing the values of all variables except 
those in common. The process of building the value ta- 
ble is descrioed in the listing. Note that for arrays 
in common* the declared dimensions in the <COM state— 
ment> ere checked against those in the common area* If 
they match ana the dynamic dimensions are consistent 
(i.e. <= declared dimensions) then the values are left 
alone, otherwise they are set eaual to those in the 
<COM statement>. For strings* the physical length is 
checked against the declared length and the logical 
length tested to be less than or eaual to the Physical 
length. If these tests fail* the Physical length Is 
set to the declared length and the logical length is 
set to zero. Smp I e variables in common are left 
untouched. 

Several errors may oe encountered while builang the 
value table. The occurrence of a null symbol (bit pat- 
tern of 0) in the symbol table means that an array sym- 
bol is used in the orogram* but never in such a way that 
its dimensionality can be determined. If the second 
word of a function entry is zero* no <DEF statement> 
for that function aopears In the program. Arrays of 
more than S00Q elements are not allowed. 

The next step is to allocate two buffers for program 
input and output. The output buffer has a pseudo file 
control block which consists of the first eleven words 
of a file table entry. if the output aevice is the user 
terminal* the third wore of the block ( logical, uni t number) 
is set to -2 and the record length set to Id bytes. If 
RUN*OUT=f i I e name* has been specif iea* then the ?0REC and 
?OUTP entries of the user teletyoe table indicate the 
device and logical record size to be used for the program 
output device. A buffer large enough to hold one logical 
recora is allocated* except for ASCII disc files which 
require a 2b6 word Duffer to contain one Physical block 
(ASCII files are blocked)* The routine STFCB is responsible 
for filling the entries in the file control block. If the 
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program was ChAiNed to* arid the output device is an ASCII 
atsc file, then the current disc address is set to the first 
disc block which was not written to by the CHAlNing program. 



The input buffer only requires a two word control block 
consisting of the tenth and eleventh words of a file 
table entry (current buffer Dointer and logical end of 
record). The buffer allocated is the same size as the 
output buffer. 

During program execution* the variables INFIL and OUTTH 
point to the first word of the "file tar le entry" for 
the program input/outout devices. The non-existent por- 
tions of the entry are not needed ana are never referenced 
OUTTb points to the entry for the outout device. bit 15 
is set if that device is the user terminal. INFIL is set 
to zero and points to the input device entry only during 
execution of an tNTtw* LINPUT* or READ statement. 

NoTfc : see ASCII file handling for special use 
of INFIL and OUTTb 

C. Decomp i I at ion 

programs are decompiled when an error occurs during com- 
pilation* puiloinq of the file table* or when the program 
is to be modified or saved in the user library. Since 
in the first of these only a portion of the program is 
compiled* the pointer SPTR is used to determine how 
much to be decompiled (a fully compileo program always 
has SPTn pointing to the first word following the pro- 
gram). The program is movea so that SPROG=PdUFF (no 
common area). The process is explained in the listing. 

0. The Routine PrnST 

PkNST Is used by poth CMPLt and DCMPL to scan the program 
and skip over those portions not affectea by compiling. 
PkNST assumes responsibility for recognizing extra <FILES 
statements> and <C0M statements> that are out of order* 
If such an error condition is encountered* SPTR is set 
to point before the statement which caused the error (it 
hasn't been compl lea). Then PRNST calls DCmPL* which 
calls PkNST. The statement causing the error is not 
seen this time, so pwnST and DCMPL can exit correctly. 
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III. EXECUTION 

A* Main Loop 

UPon completion of the value assignment In phase 2t con- 
trol transfers to XEC. After printing the program name 
(unless the program was CHAlNed to) X£C proceeds to ini- . 
t la I Ize the file table, a buffer the size of a log lea' 
record Is allocated for each file* except ASCII disc 
files which reauire puffers of 256 words regardless of 
.logical record size. Pointers to the word following 
the buffer are Placed In words nine and ten of the file 
table. The first wora of the disc address of the record 
in the buffer (word b) is set to 100000 (octal) to indi- 
cate that no record is present. word 17 is set to zero f 
indicating that no end-of-record/end-of-f I le exit has 
been specif lea. word 15 is set to as a null protect 
mask. 

Following the preoaration of files the initial execution 
status is set. The initial execution stacks are claimed 
from free user space and pointers &re set to the first 
position counter (CHRCT) is set to zero by outDuttlng a 
carriage return. Phase d has already set the BASIC pro- 
gram pointer (PkGCT) to the first statement to be executed 

Execution of a statement simulates the execution of an 
instruction on a 'BASIC machine*. The sequence number 
of the statement referenced by PRGCT is saved for pos- 
sible use by the error routne. PRGCT is advanced to 
reference the following statement. The type of the 
current statement is used to branch to the appropriate 
routine via a jump table* Individual statement routines 
return to the top of the loop. 



d. Statement execution 

<LET statement> execution consists simply of evalu- 
ating the formula which is known to contain at least 
one assignment operator and to have type compatibil- 
ity (numeric vs. string) by its acceptance by Phase 
1. 

<lf statement> execution forks on the symbol following 
the IF. The construction 'IF END 1 causes the following: 
the file reference .is evaluated and tested for exis- 
tence as one of the program's reauested files; if a 
legitimate reference* the statement reference following 
the THEN is Placea in the end-of-f i'le word of the 
file's table entry. The construction 'IF ERROR' causes 
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the statement reference following the THEN to be Placed 
in the base page variable UTRAP (which is set to on 
program termination^ abor t * or execution of a CHAIN 
statement). If not MF END* or «IF ERROR 1 * the deci- 
sion formula is evaluated and if true the statement, 
reference replaces the value of the interpreter's pro- 
gram counter* PkGCT* via the GOTO mechanism. 

<60T0 statement> execution consists of choosing a 
statement reference to replace the program counter. 
For simple GOfO's this is done trivially; for multi- 
branch GOTO's this is done by evaluating the index 
formula and choosing the statement reference in the 
corresponding list position. If the index value lies 
outside the list of statement references* the program 
counter remains unchanged. 

<GOSUB statement> execution follows the pattern for the 
GOTO except that after choosing the new value for the 
program counter* the old vaue Is savea on the return 
stack (stack overflow generating an error condition). 

<FOR statement> execution opens an active program loop. 
The for-stack is searched, for an entry with the same 
f or-var i ab le; if found* the entry is eliminated (i.e., 
the previous <FOR statement> with this for variable Is 
closed). A new entry is set on top of the for-stack 
(extending the for-stacK by six words if no entry was 
eliminated) and a pointer to the for variable's value 
entry is put into word 1. Since the first formula in 
the FOR contains an assignment operator* the formula 
evaluator* FORMX* initializes the for-variable when 
it determines the initial value. A reference to the 
statement following the <FOR statement> is put into 
word 6 of the for-stack entry (the star t-of-loop aaoress). 
woros d and 3 save the result of evaluating the limit 
value formula. If a step size formula appears expli- 
citly it is evauatea* otherwise 1.0 is taken as the step 
size. In either case the value of the step size is left 
in words 4 and 5 of the for-stack entry. The program 
counter is set to the statement following the associated 
<NEXT statement> and control transfers to the <NEXT 
statement> execution code to compare the initial and 
limit values (see flow chart). 

<NtxT statement> execution decides whether to iterate 
a loop or close it. The for-stack is searched for an 
entry with the same f or-var lab le. If none is found the 
statement is ignored and control passes to the following 
statement. If the entry is found* any entries above it 
(more recent entries) are ellminatea; i.e.* they are 
assumed to belong to nested iooos wich were not closed 
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by exceegng their limit value but exited otherwise. 
The value of the for-var table is then incremented by 
the step size ana the new value tested by subtracting 
the limit value and using the sign of the step size to 
determine w.hether a non-negative or non-positive result 
indicates 'success'. If the result is «success*t the 
program counter is loaaed from word 6 of the for-stack 
entry (the reference to the statement following the <FoR 
STATEMENTS • If the result If not 'success'* the for- 
stack entry is eliminated. At this point the Program 
counter already Points to the statement following the 
<NEXT statement> so exit is simply to the main execution 
loop. 

<RETURN statement> execution merely loads the Program 
counter from the top entry of the return stack. An 
error condition is generated if the return stack is 
empty. 

<INPUT stetement> execution assigns values to the in- 
put list for both INPUT and MAT INPUT. INITF=0 and 
MCNT is meaningless when executing an <INPUT state- 
ments for MAT INPUT* INITF = -1 ana MCNT holds the 
number (in 2»s complement) of elements of the cur- 
rent array as yet unassignea values. IF'CNT holds 
.the ordinal number of the current item in the current 
record. (Note that IFCNT is not cumulative over the 
entire execution of a statement requesting input un- 
less the request is met entirely by one line from the 
teletype). 

The <INPUT statement> executor is also used oy the 
<RLAD statement> executor when REAOing ASCII files. 
The routines INCAl (used to get an input record) and 
GtTCR (used to obtain a character from an input re- 
cord buffer) operate on user terminal input or ASCII 
file input (either disc files or devices) depending 
upon the value of the variaole INFIL. If INFIL=0» 
the user terminal is the input device. INCAL will 
initialize the terminal input buffer control block 
ano set INFIL to point to this file control block 
(actually 9 words before the control block since we 
always point to the first word of file control blocks 
but in this case we nave a pseudo control block of 2 
woras). bit lb of INFIL is set to indicate a user 
terminal instead of an ASCII file. Incal then reads 
ar\ input record from the appropriate device and GETcR 
retrieves characters from the buffer. Note that in 
the case of an <INPUT statement> we are always dealing 
with the user terminal. INFIL is cleared before oro- 
ceeaing to the next statement. 
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The general approach in execution is to determine the 
adaress and type of a variable in the input list and 
then attempt to satisfy it from the input record, 
when an error occurs in the above process* it is ex- 
plained along with any necessary corrective action 
so that errors in the input record will not terminate 
program execution. For simple input if tne next variable 
in tne list is of numeric type its value table address is 
placed into SdPTkj for array input the base address of the 
is put into SbPTk. After filling a simple variable the 
next variable from the list is taken ana a new adaress 
generated; after filling on array element sdPTK has been 
aavanced to tne next element bv the numeric input routine 
so no new adaress need be calculated. when mcnT roils over 
to zero (an array has been filled) control exists to tne mat 
INPUT cooe* which may return with another array's base 
address in SbPTR and MCNT reset appropriately. If the input 
record is empty but the variable list is not yet exhausted 
a request for additional inout Is made (signified by •??• 
rather than tne initial •?• ) • SEP* is needed as a flag to 
indicate if unaer/over f I ow ocurred while converting the 
latest numeric input* since the error message will have 
destroyed any additional Information in the input record. 
When looking for a numoer * the input record Is scanned for 
the first sign (♦ or -) * digit* or decimal point* which 
begins the number. Any other characters will be ignored 
except the ••* which will generate a recoveraole error. 

String input reouires fairly complicated analysis' 5 ^ 
the data transfer. If tne strlna variable does not 
specify the transfer length (does not ha^/e a double 
subscript), then the next string in the input record 
is transferred in its entirety ana the logical length 
of the varldole set appropriately. If the next str inc 
variable specifies the transfer length then exactly 
that much of the next strina in the input record will 
be transferred* either truncated or extended by blanks 
as necessary to achieve the specified length. The 
•next string* in the input record begins with tne next 
non-blank character or* if it is a ••* the following 
character* blanKS included. The string ends with 
first •• (which is not part of the string) encountered 
or with the carriage return (also not Part of the 
string) if no •• appears. 

fcvery data item in the input record must oe followed 
by a comma or carriage return and a comma must be fol- 
lowed by another data item. Failure to ooserve tne a- 
bove will generate recoverable errors. InTmP nolds the 
type of data being sought* INTMP = for a number or 
INTmp <>0 for a string* and is used by the error recovery 
code to prepare for the entry. 
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<ENTEK statement> execution assigns a value to a string 
variable or a simple variable. if a •■#• follows the 
ENTER* the user is port number (0-31) is assigned to the 
first variable. The <ENTER statement> is timed and the 
length of time it took to respond (tn seconds) is as- 
signed to another variable. The inout analysis proceeds 
much like an input statement with one variable* with the 
notable excetion that no error messages are Printed, 
instead* the response time variable is negated if an 
error occurs. If the user does not respond within the 
allocated time* the response time variable Is set to 
-256. Parity error returns -257* lost character 
returns -25b. This is non-amb i guous since response 
times are between 1 and 255 seconds inclusive* Also* 
for string input leading blanks are non stripped off 
and quote marks are allowea as characters. 

The <ENTER statement> executor is also used to perform 
the assignment for the LINPUT statement. The common 
coae occurs after the input record has been read. 
STINF is cal lea to set up the pseudo file control block 
for the user terminal (in the case of LINPUT from an- 
other aevice* the file control block for that device is 
used). in either case* INFIL points to the file control 
block (or Pseuao block) with bit 15 = 1 If we're using 
the user terminal. The GETCR routine is used to obtain 
characters from the input buffer, when the evaluation 
and assignment are complete* control is returned to the 
LINPUT executor if the statement is LINPUT (LFLAG s -1 
for LINPUT, =0 for ENTER) • 

<READ statement> execution ass ions values to variables 
in the <read variable list>. If a file reference is 
present it is evaluated by the routine VLFIL* which 
sets INFIL to point to the file control o I ock if the 
file is of type ASCII (INFIL =0 otherwise). If the 
file is ASCII or if the file is file zero (corres- 
ponding to the user terminal), the <INPUT statement> 
executor is usea to assign the values, otherwise the 
routine FDATA is used to obtain values from either a 
BASIC formatted file or from <DATA statements. A 
mismatch in type between a variable in the <read vari- 
able list> and the next data item* or a string too 
long to fit into its designated destination* will 
generate an error ana terminate program execution 
(see Notes on error routines for exception). 

<L1NPUT statement> execution assigns a value to a 
string variable. if a file reference is present it 
is evaluated by the routine VLFIL* which sets INFIL to 
point to the file control block if the file is of tyoe 
ASCII (INFIL =0 otherwise). If there is no file re- 
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ference or if the fie reference is for file G? an » n- 
out recprd. is reauestea from the user terminal. If 
a file reference is present? a check Is made to insure 
that the file Is ASCII and not BASIC formatted (an er- 
ror resits if the file is BASIC). An input record is 
reaa from the appropriate device. In any case? the 
<ENTER statement> executor is used to evaluate the in- 
put record ana assign the values. The <LINPUT state- 
ment sets LFLAo=-l to Indicate to LnTEk that we are 
really doing LINHUT. The <tNTER statement^ executor 
will return control to the <LINPUT statement> executor 
to Perform necessary cleanup (including the clear inq of 
INKIL? and LFLAU) . 

<PNINT statement> execution consists of identifying 
items in the print list ana sending them to the user 
or other outout device. a file reference is evaluated 
by VLFIL (aosence of a file reference or a reference to 
file indicates the user terminal). If the PkINT is to 
a hASIC formatted file then 0<=FILEfc=lb where FILE#=fMe 
reference-1. If outout is to the user terminal OUTTB 
has bit IS set and ouTMP=0. If output is to an ASCII 
device then ouTMH points to the user terminal control 
block (ano has bit lb set) and ouTTb points to the file 
control block for the ASCII device. 

If the PRINT is to a BASIC file? the ena-of-line moae 
flag is turneo off (EOL=-l). A user terminal or ASCII 
device print turns on the end-of-line moae flag (EOL=0). 
A comma or semicolon in the <orlnt list> turns off EOL 
but a comma also generates enouah blenKs to advance to 
the next fielc of lb characters if not a dASIC file. A 
literal string is written as a string of characters? less 
quotes? ana turns on EOL if not a BASIC file. An END 
writes an ena-of-file mark to an ASCII aevice or bASIC 
file. 

Formula in the <Print list> are evaluatea and the re- 
sults examined. Formulae which are string variables 
evaluate to their contents? which are then treated as 
literal strnqs. if not a strjna variaole out within a 
print to a bASlC file? the floating point value of the 
formula evaluation is written In the file in two-word 
floating point format. If a print to an AbCII device or 
user terminal ? the f loat ing Point value is converted to 
an ASCII character strina of the aecimal equivalent. LIN? 
SPA? TAB? and CTL are ignored for prints to BASIC files. 
For ASCII or terminal prints? evaluation of the function 
proauces the aesired action? so the return value is 
thrown away? alona with the following delimiter if one 
exists. For terminal or ASCII device prints? all for- 
mulae turn on tuL. If fcoL is on after processing the 
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last prnt item, a carriage return i i ne feed is printed 
on a terminal* or the output record enaed for an ASCII 
device. In addition* ASCII files must reset OUTTB and 
OUTMP and ASCII alsc files set the last operation was 
a print bit in th e file control block, unless a CTLC2M 
was the last item printed* 

Before writing a guantitv BASIC insures that sufficient 
space is available to accommodate it, CHRCT keeps track 
of the current Print position on the teletype line (0- 
71). " If the character string sent to the teletype would 
require non— blanK characters to be printed Past posi- 
tion 71, a carriage return-line feed is output first and 
CHRCT set to o. Buffer contents are always sent to the 
IOP at the eno of the print statement when doing termi- 
nal output. If an item sent to a file requires more 
woras than remain in the current record, BASIC automa- 
tically advances to the next record if in serial mode 
or exits to the end-of-record code if in record mode. 

<PHINT USING statement> execution is covered in the 
section on the formatter. 

<kfcST0RE statement> execution resets the pointers to the 
DATA block. beginning at the statement specified, or at 
the first statement in the program if none is specified, 
the pointers are set to the first <0ATA statement> found, 
or to the out-of-data condition if none is found. 

<MAT statement> execution involves many disparate tasks. 
The forms of the <MAT statemeht> may be classified as 
array I/0» array assignment, array initialization, and 
the array functions TkN and INV. for conciseness in 
coding, all forms other than array I/O use some common 
program segments. 

Array I/O Prepares each array in the list in the same 
fashion. SBPTN is set to the dynamic dimensions of the 
array (base address -2) and the operator following the 
array Identifier is Picked up for examination. At this 
ooint MAT PRINT USING calls the formatter just as PRINT 
USING does.' The EVEXP routine In the formatter takes 
care of picking up the elements of the array one by one, 
in rows. MAT PRINT follows a separate Path than MAT 
RtAD and MAT INPUT. The following operator is noted as 
soaeing the elements (comma or end-of-s tatement ) or 
packing them (semicolon). VCHK examines tne array and 
generates an error if any of its elements have value 
•undefined*. The dynamic row and column lengths are saved 
in 2»s complement. if the MAT PRINT references a BASIC 
file, the array elements aro written one py one in rows, 
each element in its two-word binary form. If the MAT 
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PRINT references the user terminal or an ASCII file rows 
are aouble soacea ana the elements within a row are 
spaced or packed as noted above* each element In Its 
ASCII decimal form. Both MAT READ ana MAT INPUT redimen- 
sion the array* i n -2 • s .comD l ement . maT PEAD calls FDATA 
for element values while MAT INPUT transfers to the 
<INPUT statement> execution to obtain element values* 
MAI PEAD #0 is treated as a MAT INPUT statement. MTO 
acts as a flag for MAT INPUT* differentiating the first 
call for input from suoseauent calls ana saving the In- 
put record. After completing i/o on an array* a common 
section of coae Prepares the next array in the list or • 
if no more remain, terminates the statement execution* 
MAT INPUT returns to the input coae to clean up there* 
MAT PRINT and MAT READ return directly to the main 
execut i on I oop. 

Array assignment consists of preparing the aestination 
ana source arrays ana execut inq a I oop which assigns the 
destination array elements one by one. The general pro- 
cedure is to assign a jump to the element computation 
coae to mop* an exit address to mexit to use after com- 
pleting the destination array* and a count of the ele- 
ments to MCNT* in 2»s complement. The code to compute 
an element returns to ML0P1* MLOP2* or mlOPJ depending 
on the number of arrays involved which require updating 
of the element aaaress. Each operation cnecKs the dimen- 
sions of the arrays involved to insure that the operation 
is well-defined; ana all elements of the source matrices 
are checkea to make sure none have value 'undefined 1 * 
Matrix multiplication does not use the element computa- 
tion loop* instead it uses row and column counters to 
tell when it is aone ana computes destination array ele- 
ments oy innter products of the rows ana columns of its 
source matr i ces . 

Array imcial ization also uses the element computation 
loop. The initialization Program first redimensions the 
aestination array (if a matrix subscript is given) ana 
then chooses the appropriate constant for the element 
values. IDN acts like ZER except that ic insists that 
the aestination array be 'square 1 and sets a special coun- 
ter to choose l.o for the value of main diagonal elements. 

TRN and INV are handled apart from the other matrix func- 
tions. For poth of these* the elements of the source 
matrix are chec*ea against the 'undefined value'. The 
source and destination matrices are then checked for 
transpositional compatibility. If TRN* then Proceed to 
transfer the columns of the source matrix to the ro*s of 
the destination matrix. 
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INV uses the uauss-jordan algorithm with row pivoting* 
This procedure converts a copy of the source matrjx into 
the identity matrix and converts an identity matrix into 
the inverse by applying the same set of operations to 
both. Since the source matrix is destroyed In the pro- 
cess* It is first copied into free user space and the 
copy treated thereafter as the source, A side effect 
of the copying produces the element of largest absolute 
value* which is used to compute a lower pound on the al- 
lowable magnitude of Pivot elements. INV then calls ION 
to set the destination matrix to an identity matrix* 
having the side effect of checking that the matrix is 
square. 

Di agonal izat ion of the source matrix and production of 
the inverse now proceeds on a row-by-row basis. The 
next unreduced column of the source is searched for the 
pivot element (the largest in magnitude). If necessary. 
rows are swapped to put the pivot element on the main 
diagonal (the corresponding rows of the destination mat- 
rix must also be swapped). If the Pivot matrix is too 
nearly singular to invert execution is terminated. 
Otherwise, the pivot rows of both matrices are divided 
through by the Pivot element. 

<ENO statement> and <STOP statement> execution termi- 
nates the program run. user error trapping is termi- 
ated* files with "dirty" buffers in core are written* 
non-shareable devices released* last change date for each 
file is updated and the user's section of the FUSS table 
is cleared. The word UONE is sent to the user terminal 
end user not running (UNR) is sent to the I0P» PBFLAG* 
AfoTRY* and CBFLAb bits in the user teletype table are 
cleared and control returned to the termination logic 
in the scheduler. 

<CHA1N statement> execution begins by evaluating the ad- 
dress of the return variable (if present)* the address 
of the program oesiqnator* and the optional expression, 
user error trapping is disabled (UTPAPsO) and a jump is 
made to the CHAIN library overlay* 

The CHAIN overlay checKS the validity of the program 
designator* performs a directory search, on the name* and 
verifies user access to the program (HFA if needed* pro- 
gram not private* etc.)* The program length is checked 
to insure it will fit* the last reference date is up- 
dated* ano variables set for return to the in-core state- 
ment executor (protected* locked* and Drivate bits set 
if needed). Return is made through the scheduler which 
first checks for aoort or disconnect and remaining time 
on time— out clock. 
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The in-core executor then takes an error exit if an error 
occurred in the Chain overlay and no return variable was 
specified. If a return variable was specified* its value 
is set and program execution continues with the next 
statement . 

It no error occurred in the overlay* any ••dirty 1 ' file buf- 
fers are written* the last chanoe oates updated, and any 
devices released. If an *0UT=* file is in use* a dirty 
buffer (if present) is written. If »0UT=* file is an 
ASCII disc file, the address of the next disc block is 
saved. The new program is then read into core. The 
CHNFG In the user teletype table is set, non-shareable 
device assignments cleared* and excess common area (if 
any) initialized to undefined. The executor then exits 
to the compile logic. 

The compile logic for CHAIN differs only slightly from 
normal compilation. The Program name is not Printed* 
ano the disc aaoress of the ASCII disc «0UT=* file 
(saved above) is used Instead of the disc oase address. 

<ASSIGN statement> execution changes the file referred 
to by a specified file number. The first operand is 
either a * or a file designator and the second is a 
file number, which is evaluated. The return variable 
address is evaluated and saved in ATMH+1 (a dummy ad- 
dress is used if no variaole I s spec i f i eo) . If the cur- 
rent file buffer is ••dirty"* it is written; and if it is 
a non-shareable device, it is released. The count of 
locked files is decremented if the file is locked. The 
file Position is marked not in use by clearing the first 
word of the file control dIocK ano the protect mask is 
cleared. The protect mask (if present) is evaluated and 
the restriction (if present) is saved in TEMH7. Control 
is then transferred to the ASSIGN library overlay. 

The ASSIGN overlay uDdates the directory entry for the 
current file, verifies user access to the new file, and 
sets up the file control block for the now file. If the 
olo file is locKed* it is unlocked ana a check made to 
insure sufficient core space for the butter of tne new 
file. Errors are returned to the in-core executor 
through the variable OPUNO, 

Uoon return to the in-core ASSIGN executor, if no error 
occurred, tne protect mask is evaluated and stored in 
the file control block. 

<SYSTEM statement> execution consists of calling the SYS- 
TEM library overlay. The overlay first evaluates the re- 
turn variaole address and notes whether its type is 
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numeric or string. The command string is evaluated and 
the command checked for validity* The type of the re- 
turn variable is also checked against the type of the 
command response. The command parameter (that portion 
of the string following tne hyphen after the command 
name) is movea into FILBF. The proper command overlay 
is then read into core replacing the SYSTEM library 
overlay. However- SYSFL has been set non zero to indi- 
cate that the SYSTEM statement called the command overlay, 

when the command overlay is finished* it cnecxs the value 
of SYSFL to see if it should call in the SYSTEM statement 
overlay for cleanup. The cleanup routine sets the re- 
turn variable value (string or numeric) and control is 
returned to the in core (SYSTEM statement) executor which 
reports a string response overflow (if it occurred) or 
else proceeds to the next statement. 

<CGhvFRT statement> execution involves conversion between 
string and numeric data. The first operand is evaluated 
to determine the direction of the conversion. If the 
first operand is numeric it is converted into a string 
using the same rules as in LIST. If the first oper- 
and is a string it is converted to a number. If an er- 
ror occurs during the conversion* a checx is made for an 
exit label. If one exists* execution continues there* 
otherwise a fatal error occurs. 

<LOCK statement> and <UNLOCK statement> execution con- 
sists of setting PS0=O for LOCK or -1 for UNLOCK and then 
calling the LOCK/UNLOCK library overlay after evaluating 
the file reference and saving it in okDNO. Tne overlay 
then evaluates the address of the return variable - if 
none is present a dummy address is used. The variable 
ATMP is set to i f a return variable is present. A 
check is maoe to insure that the file is not ASCII. At 
this point the LOCK and UNLOCK statement executors 
diverge. 

The UNLOCK executor insures that the file is locked* (by 
checking the I ock bit in the file control block) then 
scans the lock queue to re— schedule the first user on 
the oueue who is waitinq to LOCK this file. The file 
locked bit »n the FUSS table entry for this file is 
cleared* LCKFL is decremented (count of locked files for 
this user), ana the locked bit in the file control block 
is cleared. The active buffer pointer for the file is 
bumoed to the end of buffer and the buffer contents ore 
written to aisc It the buffer is dirty. 
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The LOCK executor checKS that the file is not already 
locked by this user (thru the FCB lock bit). If it is* 
a fatal error exit is taken unless a return variable is 
specified* in which case a one is returned. The FUSS 
table is scanned to see if any other user has LOCKeo the 
file. If the file is already locked ana a return vari- 
able was specified the value one is returned (file 
already I ockeo/uniocKed) • If no return variable was 
specified* the user is put on a LOCK queue and the disc 
address of the tile is Placed in the teletype table TEMP 
words. If the file is not currently locked* a check is 
made to see if this user currently has any other files 
locked (LCKFL=0) , If so* a return variable must oe 
present or a fatal error results. The FUSS entry for 
this file is marked locked* as is the FCB entry. The 
count of locked files (LCKFL) is incremented. If the 
user currently has a record in the buffer* it is writ- 
ten to disc (if dirty). The recora is always read anew 
from the aisc'ana the active pointer is reset to the 
beginning of the record. Control is then returned to 
the in-core statement executor through the scheduler. 

The in-core executor reports fatal errors, if also 
takes care of releasing terminal output buffers for 
printing and Placing the user in output wait if he 
tried to I ock an already locked file. 

The scheme of writtina dirty reords on LOCK or UNLCOK 
and always re-reading the current recora on a LOCK* in- 
sures the user that he always has the CUCCSQ1 disc re- 
cord. It is also imoortant to note that a user Placed 
on the lock queue must not be swapped out by the sche- 
duler before his status is changed to output wait - 
otherwise the user wno has the file locked may unlock 
the file and reschedule the use by resetting the PACT 
bit. However, if the status isn't output wait the user 
will not be rescheduled (the PACT bit will oe turned 
off and ignored) . 

<CREATE statement> execution starts by setting 8TMP=-1 
to flag the statement as a CREATE and not a PURGE which 
uses the same in-core executor hut which uses a dif- 
ferent Horary overlay. The return var laole address is 
evaluated and saved* the file name is evaluated* and the 
file length is evaluated. The record size is evaluated 
if present. The CREATE library overlay is ca I I ed . af ter 
first setting SYSFL to indicate a Drogrammatic call. 
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The CKEATE liorary overlay Is also used to process the 
CREATE command. The overlay creates the file with the 
specified parameters If room exists on the system and 
in the user's account. Each record of the file is ini- 
tialized to. an end-of-file* Success or failure is indi- 
cated via the return variable. see listing for additional 
detai is. 

<PURGE statement> execution sets BTMP=0 to flag the 
statement as a Pukge* The return variable address is 
evaluated and saved and the file name is evaluated. 
SYSFL is set to indicate a programmatic call and the 
statement execution continues in the PuwgE library 
overlay. 

The user's library is searched for the file name and 
a check made to insure that the file is a -data file and 
not a program file. The FUSS table is checked to deter- 
mine whether the file is in use eno» if not» the file is 
deleted. Success or faiure is indicated py setting the 
return variable. see listing for additional details* 

<AQVANC£ statement> execution first evaluates the file 
reference and the skip count. A cJ*eck is made to insure 
that the file Is not ASCII* Items in the file are 
SKipped until either the skJp count is satisfied or an 
eno of file is encountered. The return variable address 
is evaluated ano the number of items not skipped (if EOF 
was encountered) is Placed in the variable. 

<UHuATE statement> execution evaluates the file re- 
ference ano checks that the file is not ASCII* The file 
control block is cnecked for write capability* The ex- 
pression or strinq is evaluated* The type of the next 
item in the file is checked. if an EOf • an error exit 
is taken. If the file contains a numoer • the expres- 
sion in the UPDATE statement must have evaluated to a 
number. If so* the number is Placed in the file. If 
the file contains a string the expression must have eval- 
uated to a string. The strino is transferred* and is 
either truncated or blank-padded to the same length as 
the original file string* If an update was successfully 
performed* the dirty puffer bit Is set in the file 
control block. 

<IMAGE statements <C0M statements <OIM statements 
<DEF statements <OATA statement> and <FIL£S statement> 
do not require statement executors as they only contain 
information which is reouired for comoiiation or during 
the execution of other statements. The <REm statements 
of course* reouires no executor by definition. 
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The Formatter 

The formatter is responsible for PRINT USInG end MAT PRINT 
USING statements. It consists of three sections: the PRINT 
and MAT PRINT syntax routines* the EPRUS subroutine called 
from PRINT and MAT hkInT executors? ?nd the formatter proper. 
IMAGE statement syntax and execution will not be explicitly 
discussea beyond mentioning that Syntax merely stores the 
IMAGE string without any validity checKS and that IMAGE state* 
ment execution is a no-op. 

PRINT USING ana MAT PkInT USING Syntax 

After recording an optional file reference the PRINT and MAT 
PRINT syntax routines checK for a USING kev*oro (suoroutine 
USTCK). USTCK allows a strmq variable (USING A$) » a string 
constant (USING" ••fn^U" ) • or a statement numner (USlNo Ld3*+) „ 
If end of statement* acceot it* otherwise aemana a semicolon 
and return to (P+c?) • For PRINT USING* we accept a print func* 
t i on (CTL* LIN* SPA* or TArj)* a strino variaole* or an expres- 
sion. Multiple items must be separated py commas. MAT PRINT 
USING only allows Print functions or arraw identifiers* 
separated by commas. 

PRINT USING and MAT PKInT USING Execution 

After validating a possible file reference (VLF'Il)* a call to 
execute PkINT USlNb (EPwus) is made from ooth execute print 
ana execute mat print. EP^US determines whether or not we 
have a PRINT USING or a MAT PRINT USING* sets FFLG to indi- 
cate the respective type of print statement* and then sets 
up a Pointer to the format string. Finally* the length of 
the format strinq is calculated and the formatter is jumped 
to. 

Formatter Execution 

The formatter wotks in two passes. The first Pass scans for 
a legal specification. After this* oass two is entered to 
either output a number or a string. Blanks are output on the 
flv in pass 2. After outoutting a number or string according 
to specification* pass one is returned to ana processing con- 
tinued. The comments in tne listing are unusually cfear and 
should guiae well. 
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NOTES ON THE ERROR ROUTINES 



Errors are handled by routine SERR* reached by a jumo 
base page error jump taole SERRS. A JSB SERRS ♦ i» I 
detection of error i. The subdivisions SERRS* RERRS, 
WERRS of the jump tabie correspond to sections of the 
message table containing syntax* run-time* format and 
only messages* respectively. 



through the 
s igni f ies 
FERRS and 
error 
warning- 



Syntax errors* except when detected in tape mode* are promoted by 
the message ERROR. Any response except a carriage return will 
cause the appropriate error message block to be read into the 
library overlay region. The message will be transferred to the 
ERSEC table and printed on the user terminal. 



Syntax error detected whi 
error psueoo-statements I 
These Psuedo— statements w 
received statements with 
Provision is made in F-NOP 
statement when given its 
counter (ERRCT) whenever 
statement. (Note: An er 
by FNOPS when another sta 
ready to replace ity. ov 
conversions in syntax mod 
only after accepting the 
Since no printing can be 
CHOUF suppresses settinq 
are not reported when in 



le in tape mode are handled by accepting 
n place of the erroneous statements, 
ill be replaced by any subsequently 
the same line number. Consequently* 
S* which returns the location of a 
seouence number* to decrement the error 
the statement found is an error psuedo- 
ror psuedo-statement will only be found 
tement with the same sequence number is 
er/under f lows detected during number 
e cause warning messages to be issued 
statement* if it is otherwise correct, 
done while in tape mode* the routine 
of the flag and these potential errors 
tape mode. 



If the error is not a syntax error* a check is made to determine 
if the user has enabled Program error trapping via the »IF 
ERROR 1 statement. If he has* and the error is not either PROGRAM 
BAD or a compile error (which are not trapped)* then the error 
number is saved in LERR and the line number in LSTAT. The user 
can access the values by use of the SYS function. If the error 
was only a warning* statement execution continues. If it was a 
run-time or format errors the current statement is terminated and 
program execution resumed at the line number specified in the 
tlF ERROR 1 statement. 

If the user is not trapping errors and the error is either a run- 
time or format error, the ASCII file print flag is turned off 
(if set)* UNR is sent to the IOR* and PBFLAG* CtJFLG* and ABTRY 
bits in the teletype table are cleared. The error message is 
printed (as in the case of syntax). If a buffer has been 
allocated for LIST* indicated by SPACQ=1 in the teletype table* 
it is de-allocated. The CHNFG and SPACu bits are cleared and the 
OUT= file is killed (if one exists). All open ASCII files are 
killed. Any dirty buffers for BASIC formatted files are written 
to disc. The last changed dates are updated* the user's FUSS 
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cleared and a jump is made into the scheduler's termination 
logic. The user status will be set to idle ana he will be 
removed from the Queue, 
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BASIC Core Macs 



SYNTAX (Phase i) 



! 



SPPOG=P6UFF-> 



PbPTR=SbUFA-> 



SBPTH-> 



SYNTQ-> 



SSTAK-> 



LwAUS-> 



{ System Base Page 



USF-> — 



{ Subroutine Entry «, 

} Points and User Variables \ 

I J 



{ Previously - entered 
{ Program Statements 



Current Statement 
buffer (10a words) 

Syntax Stack 

Avai lable user space 



user Swap Area 
(10240 words) 



bASIC and System 



77777 

BQiOtfiCS 

USfc Fixed* first word of user swap area 

PbUFF Fixeo, first word of program space. 

SPPoG Fixed, Mrst wora of program. 
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ShUFA variable, first word of statement 
bei ng syntaxed. 

PBPTP variable, first word of program soace 

not usea by previously acceptea program 
statements. 

SfcfPTP variable, first word not usea by statement 
being syntaxed. 

SYNT(J variable, first woro of syntax stack, 

SS1AK Variable, last word of syntax stack. 

LWAUS Fixea, first word not In user swap area. 
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CQtaeiLAHQU-iebesfi.ui. 

CQtDeiiflliQQ 

o -- 



USE-> 



PfaUFF-> 

SPROG-> 
SPTR-> 



System ease Page 



{ Subroutine Entry 
J Points & user 
J variables 



LWAUS-> 



System 



77777 



j Common Area 


J 


i bASIC 


i 


! Program 


\ 

• 

• 
« 




• 

• 


{ Symbol 


• 


! Table 


• 








• 




• 


I Ava i 1 ao 1 e 


i 
• 


{ user Space 


• 
• 




S 




• 

• 


S BASIC and 


« 

s 




I 
1 

I 



— — <-SYMTb 



<-PBPTR 
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COtfeiLAlIObi..iefcflS£-Ili Cont inued 
yalue-SlQcage.ailQCStiQD 



System Base Page 



USE-> 



Pbu>F-> 
SPPOu-> 

SPTk=SYMTB-> 



LwAUS-> 



77777 



Subroutine fcntry 
Points & User 
var iabi es 



Common Area 



bASIC 
Program 



Symbol 
Table 



Kile Table 



Value Table 



Avai I aol e 
user Soace 



bASIC and 
System 



<-FILTB 
<-VALTH 



<-PBPTk 



SPROG - variable* first word of proaram. 

SYMTH - variable, first word of symbol table. 

SPTP. - Variable, word of program being processed 

FILTB - variable, first word of file table. 
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VALTB - Variable, first word of symbol value taole 

(FILTB = VALTb if no <FILES statement> is in program) 
PBPTR - Var labble* first word available of user space. 
SYMT8 and SPTR &re not changed after compilation. 
FILT6 ana VALTB ^re not changed after allocating value storage 
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o 

System Base Page 



US£-> 

PbUFF-> 
SPkOb-> 

SYMTB-> 

FILTb-> 

VALTfc-> 
If SS-> 

9 Woras 



LwAUS-> 



77777 



Subroutine Entry } 
Points *> user ! 
Variables i 



Common Area 



bASIC 
Program 



Symbol Table 



File Table 
value Taole 



format StaCK 
File buffers 
Keturn stack 



For-StacK 
Temporary Stack 



Operator /operand 
Stack 



Ava i l ap I e 
user Space 



bASIC and 
System 



<-FCO*fc 



<-RTKNO 
<-RTNST 
<-FOkO 

<-FORST 

<-TMPST 

<-OPTPO 
<-OPL)ST 
<-PbPTn 
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EXECUIlQW-jebaSfi-lIIl-CQDtiDUfiCl 

IFSS - variable, first word of format stack 
FCORE - Variable, first word not used by Phase II. 
KTRNQ - Variable* bottom of return stack 

return stack) 
RTNST - Variable, top of 
FORQ - Variable, bottom 

f or-stack) 
FORST - Variable, top of 

entry) 
TMPST - Variable, top of 

2-word entry) 
OPTRO - Variable, bottom of operator stack. 
OPDST - Variable, top of operand stack. 
PBPTW - variable, top of operator stack. 



return stack 

of for-stack (sixth word preceding 

for-stack (points to latest 6-word 

temporary stack (points to latest 



FCQRE* RTRNQ, and hOku are not Changed after 
execution. 



ini t iat ing 



Entries on the operator ana operand stack are one word each and 
interleave (i.e., alternate words belong to one stack). All 
stacks beyond the return stack grow and shrink as needed so long 
as user space is available. 
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BASIC Internal Representation 

BASIC statements are represented internally by the sequence 
number followed by the length in words (including the sequence 
number ana length woras) followed by the statement body. The 
statement booy is composed almost entirely of operator-operand 
pairs which occupy from one to three words each. Null ooeranas 
ana operators are usea when necessary to maintain the 
operator-ooer ana correspondence. The operator resides in bits 
14-9 of a word; the operand uses bit ibt bits 8-0 9 and sometimes 
whole aaaitlonal woras immediately following. 

lysciablei.ocecdDdS 

! ! Operator J 0J Null ooerend 



Operator ! Name | J String variable 



operator ! Name J 1-3 J Array vanaole 



Operator ; Name \ *»-16(8)| Simple Variable 



Operator j Name • 17(b) | Function variable 



Bits 6-0 are aenerally divided into two fields as follows: 
a name field (bits b-<4) ana a type field (bits 3-u). The name 
field holds a value between 1 and 3d(ti) corresponding to A-Z (for 
functions* corr esoona i na to FNA throuah FNZ). A type of 
identifies a string variable (e.g. 3*0 represents CS). Tyoes 1 
? identify array variables of a 1 mens t i ona I 1 ty one ana two 
respectively (e.g. t+*d represents DC*f*3 while type 3 identifies 
an array ariable whose a i mens iona I i t v cannot oe determined by its 
immediate context. Type <♦ identifies a s i mp I e variable with no 
diait (e.g. I ♦<* represents A) while types b - 16(d) identify 
simple variables whose names include the aigit 0-9(10) 
respectively (e.g. t>* 7 represents Fd). Type 17(d) identifies a 
progr ammer-aef i nea function (e.g. Jditi)* 17(a) represents FnZ). 
Name fiela values of 33(fr) thru 3o(t>) correspond to extended 
string representations (e.g. A0i thru Zl$). 
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•CQDStaOli.OBfiCSDCtS 



Operator } Name ; 4-16(8) J 



Parameter 



J 1 ! Operator J Name j 17(B) 



Pre-defined Function 



! 1 J Operator { 3 
! Binary Integer 



Formal Oi mens ion/ 

Branch Address 
List 



binary Integer 



S 1 J operator { 




J High Mant i ssa 




5 low Mant ! Exponent 





Numerical constant 





: o s i «•«) i 


0*55(10) 


• 


• 

• 
• 




1 
1 

e 

• 


J Character 


j Character 


• 



Str ing constant 



A parameter (which can only appear Inside 
differs from a simple variable only in th 
name of a predefined function may ranget 
from to 31(8) or 33(6) to 37(6). (CTL to 
flagged (bit 15 set) operand of 3 I dent if 
dimension In a <01M statement> or <C0M st 
following word) or a branch address list 
sequence numbers in the following words)* 
indicates that the followsno two words 
constant (all numerical constants within 
represented). The operator with internal 
signals the start of a string constant, 
the wora has a value from to 255(10). i 



a <DEF statements 
at bit 15 is set. The 
in the standard system* 

SYS or ZEW to TRN) • A 
les either a formal 
atement> (value in 
(one or more statement 
A flagged operand of 
hold a floating-point 
a program are so 

code 1 is ••• which 
The operand Portion of 
nai eating the number of 
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cn^racters in the constant, 
per word* and the closing •• 
i nternal I y • 



The string follo*s« two characters 
is not explicitly represented 
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The table below gives the Internal representation of the BASIC 
operators. Those operators which manipulate the formula 
evaluation stack during execution hae associated priorities. 
BASIC statement types ar® represented in the following table* 
They can be di fterent i ated from BASIC operators because statement 
types must appear only as the first operator in a statement. All 
numbers are in octal notation. 



OP PRIORITY ASCII 



BASIC Operators 

OP PRIORITY ASCII 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

?S 

26 

27 

30 



1 

1 

13(1) 

11 

11 

11 

'2 

2 

7 

7 

10 

10 

12 

b 

5 

5 

5 



(end-of ~f ormul a) 


31 




4 


(unused) 


M 


32 




4 


and 


♦ 


33 




3 


OR 


• 


34 




b 


min 


* (FILE) 


3b 




6 


MAX 


(unused) 


3b 




5 


<> 


(unused) 


37 




b 


>3S 


(unused) 


40 




b 


<5B 




*1 




11 


NOT 




42 




12 


** (power 




43 






USING 




44 






PR 


+ (UNARY) 


45 






WR 


- (UNARY) 


4fe 






NR 


• (subscr id t) 


47 






ERROR 


as (assignment) 


£>0- 


b7 




(unused) 


+ 


bO 






END 


- 


bl- 


62 




(UNUSED) 


# 


63 






INPUT 


/ 


o*. 






READ 


A 


bb 






PRINT 


> 


tob- 


-73 




(UNUSED) 


< 


74 






OF 


# 


7b 






THEN 


= (eoua 1 ) 


76 
77 






TO 
STEP 
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BASIC Statement Types 
OP ASCII OP ASCII 



0-31 


(unused) 


5b 


NEXT 


32 


SYSTEM 


56 


GOSUB 


33 


CONVERT 


5 7 


RtTURN 


34 


LOCK 


60 


tND 


4b 


UNLOCK 


61 


STOP 


3b 


CREATE 


b2 


DATA 


37 


PURGE 


63 


INPUT 


40 


AOVANCE 


64 


READ 


41 


UPDATE 


bS 


PRINT 


42 


ASSIGN 


66 


3 RESTORE 


43 


LINPUT 


67 


MAT 


44 


IMAGE 


7 


FILES 


4b 


COM 


71 


CHAIN 


4b 


LET 


Id 


ENTEw 


47 


DIM 


fj 


•IMPLIED 


50 


DEF 


l<+ 


(unused) 


51 


REM . 


75 


(unused) 


52 


GOTO 


76 


(unused) 


53 


IF 


71 


(unused) 


54 


FOP 







LET* 
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Pre-oefined Function Table 

operator - operand Pair Format 
15 14 9 d 4 3 10 

/!/ operator / Code / 17 / 



CODE 



ASCII 



coot 



ASCII 






CTL 


1 


TAH 


2 


LIN 


3 


SPA 


4 


TAN 


5 


ATN 


6 


EXP 


7 


LOG 


10 


«BS 


11 


SQM 


12 


INT 


13 


RNO 


14 


bGN 


15 


L£N 


16 


TYP 


17 


TIM 



20 


SIN 


21 


COS 


dd 


BRK 


23 


ITM 


2* 


REC 


25 


NUM 


2b 


POS 


27 


CHRS 


30 


uoss 


31 


SYS 


32 


(unused) 


33 


ZER 


34- 


CON 


3b 


IDN 


36 


INV 


37 


TRN 
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txtended string wepresentat i on 

15 14 9 5 4 3 

/0/ Operator / Name / Sub-OP/ 

STRING VARlAbLt" NAME SUd-OP 



A$-Z.i 


1-32 





A0i-P04 


33 


0-17 


UOt-ZO* 


34 


0-11 


A1$-P1S 


3b 


0-17 


ulb»-Zll> 


Jb 


0-11 
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Some examples of BASIC statements in their internal form are 
given below. Note that actual function parameter formulas* <0EF 
statement s> formulas, and subscript formulas appearing i n <MAT ' 
statements) reauire end-of-formu I a operators to signal their end 
whereas most formulas end either with the first operator which 
does not manipulate the formula evaluation stack or with the end 
of the statement. Note also that constants are considered signed 
only within a <OATA. statement). ASCII numbers are decimal* 
Internal numbers are octal in the presentation below. 



10 



LfcT Wl = Y = <b =s C) a 3*ACI*J+K) 



12 






sequence number 


20 






length 


46 


27 


6 


L£T 


Wl 


17 


31 


4 


s 


Y 


17 







s 




13 


2 


4 


( 


B 


30 


3 


4 


= 


C 


10 







) 




1 24 







A 




060000 






3.0 




000004 










22 


1 


2 


* A 




12 


11 


4 


I I 




16 


12 


4 


* J 




20 


13 


4 


+ K 




11 







i 





20 DIM ACS)* CC6*»12] 





24 








14 









47 


1 


1 


1 


12 


b 


3 





11 










2 


3 


2 


1 


12 


6 


3 


1 


16 


14 


3 





11 
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30 DtF FnC (X) = X + AG 



40 RfcM AfcK 







36 








10 







*0 


3 


17 


1 


13 


30 


4 





10 







1 


17 


30 


4 




20 


1 


5 














SO 

b 
bl 4U 



bO 


GOTO 


A i 






62 








7 







52 


1 


4 


1 


74 


12 
24 
36 


3 



10f 20, JO 



60 DATA -!♦ "AHC" 

74 

11 

1 62 

10000U 

0000U0 

2 

1 3 



0405U2 
0M4OU 



70 


MAT 


KLAD *K?a£ 1 J 




106 








11 









67 










64 










4 


13 


4 





3 


1 


1 





12 


11 


4 















11 
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BASIC Variable Storage Allocation 



PROGRAM FRAGMENT 



DEF 



.. ( 



t 



FNC 



SYMBOL TABLE FRAGMENT 



K 



FNC 



D3 



A[*] 



A[ 3 



3$ 



VALUE TABLE FRAGMENT 



W 060000 



dimensional i ty 



*— * 



dimensional i ty 
local ly unknown 



A[l] 



A[2] 



A[3] 
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000004 



100000 



000000 



040000 



000002 



000000 



1 



value of 
simple variable 
declared 
dimensions 
dynam i c 
dimensions 



active 
elements 



inactive 



element 



physical length/ 
logical length 



character 
string 



The symoo.1 .table consists of two-word entries* one for each 
unique symbol occurring in the user's program. The first word of 
an entry is the. Internal representation of the symbol as 
previously describee. The second word of the entry is a Pointer 
to the value of the symbol. For a programmer-defined function 
the value is the defining formula in the <DEF statement>. The 
value of a simple variable is a two-word floating point number. 
The value Pointer of an array is its base address (i.e. the 
address of its first element)! when an array is dynamically 
redimens ioned to occupy less than its Physically allocated 
storaae* it occupies a contiguous block justified to the low core 
portion of its element soace. Since array symbols may not have 
dimensionality locally defined (e.g. MAT A=6)« array Symbols may 
have a M don»t Know" entry in the symbol table in addition to the 
dimensioned entry, both entries have the same value Pointer. 
The declared and dynamic dimensions occupy the four words 
preceding the element space in the value table. The value of a 
strino is also its base address. A string is a character array 
(packed two elements Per word in contrast to the two words per 
element for numerical arrays). Its physical (declared) length 
and. logical (dynamic) length occupy the word Immediately 
preceding its value space. 

The value table and common area are simply the concatenation of 
the values for the symbols in the program* excepting programmer- 
defined functions. 



5-38 



FILt TABLE ENTRY (ASCII files) 

111 number of records In file j 
{ J ( If not disc f I le ) ! 



dirty record bit 
dirty file bit 






I logical record size 



— I-I-I 



read access 
write access 



! -1 for ASCII disc f I le { 
I LU# for non-shareable device } 

-— — — —-.—,™—.——— ———*-— last oper< 

5-J-t — atjon was 



• m, I 



I 



I 



i input next disc adaress 
J— to be read 

I output disc adaress In 
I buffer 



• „. — 



base 

di sc 

address 



last word ♦ I 
of buffer 



( byte ) 
( pointer ) 



current buffer ( byte ) 
oointer ( Pointer ) 



output -bytes left in record 
input =>logical record end 



• „. ,_ 



» mim , 



file 



name 



(unused) 



file owner • s 
id 



eof /eor ex i t 
address 



soft error ex i t 
(not implemented) 



a wr I te 
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FlLt TAHLE ENTRY (BASIC files) 



dirty record bit — 
dirtv file bit — 



read access — — — 
write access — — ■ 



0} number of records in file | 



J 



logical record size 



-!-l 



(unused) 



_ • _ i 



d I sc address 

of record 
file buffer 



base 

disc 
address 



last word + i 
of buffer 



( word 
( pointer 



current buffer ( word > 
pointer ( pointer ) 



output -bytes left in record 
input =>logical record end 



file 



name 



protect 

masK 



file owner • s 
id 



eof /eor ex i t 

adores s 



soft error ex i t 
(not implemented) 



■— f i le is 

I ocked 
by this 
user 
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ElLE-IabLE 

The file table consists of one eighteen word entry for each file 
or place-holder (•»*•«) in the FILES statement. Bit 15 of the 
first word distinguishes BASIC files from ASCII files. Bit 15 of 
the second word is set when an I tern Is stored In the buffer* so 
that only records which are changed will be written to the 
appropriate device. Bit 14 is set when a record is written to 
the device and is used during Program termination as a basis for 
updating the last changed date word in the >ile»s directory 
entry. Bits 15 and 14 of word four are used to indicate that the 
user has read and/or write access to the file (if set). Bit of 
the same word is set if the file is BASIC and the user has 
executed a LOCK statement. Bit 1 is used to indicate that the 
last operation on an ASCII disc file was a write. 

A logical record-sizeo buffer Is associated with each file table 
entry* and is accessed through pointers in the entry. An 
intra-buf f er pointer designates the next portion of the record to 
be written or read. A fixed pointer to the first word not in the 
buffer acts as a bouno on the intrabuffer pointer. 



EILE-COUIEUIS 

There are 4 data types possible in a BASIC file. A string has 
bit 9=1 and the length in characters in the lowest 7 bits of the 
first word* followed Dy the string packed k characters oer word. 
A two-word floating point number has the upper two bits of the 
first word different* except for a zero* which has both words 
zero. An end-of-fi»e is a -1 * and an eno-of-record is a -2* in 
the first woro. 

Data written to or read from a file is first exclusively ORed 
with the fifteenth word of the file table entry. This has no 
effect* of course* unless that word is nonzero. It will be 
nonzero only if an ASSIGN statement has been used to specify the 
file* and the statement included a protect mask Parameter. End- 
of-fi|e marks* end-of-r ecoro marks* floating point zero* and the 
first word of strings are not masked. The entire buffer. is 
masKea or unmasked when written or read from the disc. 

ASCII files contain only strings. ASCII disc files are blocked. 
Each record consists of a one word byte count followed by the 
actual character string, no carriage return or line feed is 
appended to the string - these are considered to pe the record 
terminator only for user terminals. Non-disc ASCII files are not 
blocked. Each Physical record eouals a logical record and the 
length of the record is determined to be the length of the 
Physical record. 
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2000/COMRUTER SYSTtM bASIC FORMATTED FILES 

Block Size - logical size from 64 to 266 words 

- default size is 266 words 

- Physical size is always 266 words 

File Buffers in Core - one record's length buffer per.Hle de- 
clared In program 

- written to disc when different b I ock 

of that file requested by user 
program 

- written to disc by normal Program 

termi nat i on 

- buffers ere swapped in ana out with 

rest of user program 
Access Mooes - seauential 

- I i ke mag taoe 

- automatically pass over record marks 

until file mark encountered 

- random 

- logical blocks are addressable 

- within a block* still sequential 
Record and File 

Indicators - logical file mark (LEOF) 

- creating a file places a logical EOF 

mark as first word in each block 

- writing in that block erases that 

lodical EOF mark 

- user program may write LEOF using 

PRINT. •••• «ENU (out continuing 
to write sequentially from that 
poi nt will erase it) 

- LEOF replaces LEOR that might other- 

wise be wr i t ten 

- logical record mark (LEOR) 

- automatically written after last datum, 

if block not full, and if PRINT.... ., 
END not used 

- Physical record mark (PEOR) 

- defines the absolute size a block; size 

defined by user creating the file 

- physical file mark (PEOF) 

- the absolute end of the last block of 

a f i I e 

- IF END. ... .statement will be executed in the 

circumstances described in the table 
on f o I I ow ing Page 
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RANDOM 



5-43 



ElLE-lItW 
DEEI&IUQblS 

BECQBD-fcJABKS 



-2 = 177776(b) s logical record mark 

logical record mark may also be detected as the physical 
end-of-record 



Ellfc._fc!GBKS 



-1 = 177777(8) = logical file 

logical file mark may also be 

mark of a file - I.e.* the 

file is pre-definea in the 



mark 

detected as the last 
number of records In 
sy s tem 



record 
any 



SIBIbGS 



bi t 15 



10 * d 



_»•— •»»«.••»••••• I a. • •■ * ..B.f»a... a i.a B a.>.ili V . M . 



First word 
Format 



000000 



HO 



Str i ng I ength 



«»•■■.»«»■»»«■•.••— <•••»* —«-—•»—•»■••-•.»•.— «,^»-.««™»— ••«—•. 



Str i ng 
Iaent i f i er 

f- lag 



In positive characters 
1 <= length <= dbb 



ASCII String characters are then packed into consecutive words* 
two Per worg* left justified with byte wasted if odd length 



s tr i ng 
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ELQ&IibG_eolBl-fcig*&EBS 

- identified by default (i.e.* none of the above three) 

- standard HP 2100 format 



bit 15 



8 7 



word 1 



wora 2 



MSb of fract ion 



LSb of fraction ! exponent 



sign of fraction 



IS 



sign of 
exponent 
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UPoate Last Change Date Routine 

Each file and program entry in the directory has a word 
containing the hour of the year when the entry was last changed. 
It is necessary to upoate this word for files when a Program is 
terminated for any of the following reasons: normal termination, 
CHAlNing to a new Program, error termination, aoort and when a 
SLEEP or HIBERNATE command is issued. 

The DFCHK bit in the user's ?F*LA(j word in his TTY table is set to 
1 If there were any files statements in the Program. This 
determines whether the LCD routine will be called,, When it is, 
each file table entry is examined. If bit 14 of wora d = i , the 
file has been written on, so the last Change date must oe 
updated. This bit is set by the wRPUF or OU'fttF routines 
depending upon whether the file is BASIC or ASCII respectively. 
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6ASIC Run-Time Stacks 



BfilUCD-SIfiCS 



RTRNQ — > { 



\ return aadress 



RSfoST — > 1 



> 

- > • 
t > 
J > 9 words 

> 

> 



The return stack Is 
of f Ixed length* 
holding from to 
20 one-word entries 
at any t ime. An en« 
try is the absolute 
address of the 
statement following 
the G0SU8 which 
Placed the entry 
on the stack* 
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For-StacK Entry 



{pointer to value 
} of for-var lable 



limit 



val ue 



step 



s i ze 



Program (-ragment 



two-word 



f I oat i ng Pt. 



number s 



The for-stack is of 
var i abl e I ength» 
containing one six- 
word entry for each 
for-loop which is 
current I y act i ve. 
Si nee the limit 
value and stop size 
are kePt in the en- 
try* they may not 
be Changed within 
the for-loop» The 
value of the for- 
vanaole is the one 
Keot i n the va I ue 
table* so this may 
be altered by state- 
ments within the 
f or-l oop. 



!<Knk statement> 



>! 



succeea i ng 
s tatement 
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OPERATOR/OPERAND STACK FRAGMENTS 



LET A = B+C*D 





" * 1 




Temporary 
Stack 




y A . . 


OPTRQ-> 


(unused) 




V B 




start-of 
formula operator 




/ c 




B 


OPU.i > 


J 




+ 




(unused) 


PBPTR-> 


* 




avai lable user 
space 


LWAUS> 


i 







TMPST* 


floating point 
number 




\ 




• A 


0PTRQ-> 


(unused) 


0PDST-* 


S p+fftn .,«.,„ 






-fr 


start-of- 
formula operator 


. 


(unused) 


PBPTR-* 


- 




aval lable user 
space 


LWAUS-* 


L^^- 1 --*^^^ 



TEMPORARY 
STACK 




OPDSTh 



0PTRQ+ 



(unused) 



(unused) 



TEMPORARY 
STACK 



+PBPTR 



All operands (checked words) are addresses (i.e., C represents a pointer to 
tjw value of the simple variable C) . Bits 7 -. of an operator entry contain the 
ors identifying code (See 'Basic Operators* Table) while bits 15-8 contain 
the operator's priority. Note the al ternate-word structure of the stack's. The 
temporary =;tack holds inteimediate values during the formula evaluation. 
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BASIC Language Processor Tables 



The two areas of core labelled SBJTB and USER contain the 
mechanism allowing different users to exercise different portions 
of the language processor without interference. The language 
processor makes its subroutine calls to the labels in the area 
beginning with USER. The word following a subroutine entry point 
is an indirect jump through the appropriate eddress in the area 
following SBjTB. When a user is displaced by the System* his 
registers are saved at USER and the area of core from USER to 
PBPTR.I inclusive is aumoed onto his track of the disc. Thus* a 
complete record of the l anquaae processor's status with respect 
to mm is preserved. The only thing particular to a user which 
remains when he is snapped out is his own teletype table. 

The tobies headed by PDFTB (which must De in oase page). SYNTb* 
XECTB. ano FOJT are jump tables. The method in the last three 
cases is to compute a decision number* aad the base address of 
the table, and transfer through the entry thus designated. The 
pre-defined function table Is used by the formula evaluator to 
enter the cooe for evaluating pre-defned functions. 

The tables headed by uunTE and MCBOS have several uses. Their 
entries are explained in the listing and their use will oe 
explained In those routines which access them. The Error Jump 
Table (at SERPS) is explained along with the error routines. 
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S y nx h x 



( SvHTX ) 




Clean 0? 
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APPEND 

Tho APPt'ND routine is called bv a user to append a Horary 
program to his current orooram. The operation i s the same as 
GFT for steps i-6« ana then continues as follows: 

9. Check that tne Program to be apoenaed is not semicompiled and 
has no common area, set the date into word b of the 
directory entry and write it back. 

10. Load user's current program and cell DOPL. ChecK that the 
oroaram to oe appended will fit* and if so* read it in at 

the end of- the current program. jf the redo is unsuccessful* 
fai I • 

11. If the current program is not null* search it for tne 
seauence number of the first statement of the aopended 
program. If OKay. update Phptp. 

12. If the appengee belongs to tne user (?1D = ?P^1D) then 
clear protection bits in the ?namp" woros. 

13. If the appendants in is not the same as the user's ID or 
?PPID then out tne aopendant's ID Into ?^PI0. Also inclusive 
or the protect bit in the user's TTY tarle (the third word of 
?NAMt* bit lb) if tne appendant is protected. 

14. Set main and terminate. 



ASSIGN 

The ASSIGN overlay is used ov HASIC to process an ASSIGN state- 
ment in a user's program. The function of the routine is to 
replace information in tne file control oIock of tne referenced 
flip with information thrit pertains to tne new file. we proceed 
as foil ows : 

1. F i no old file»s oirpctory entry and update it« if necessary, 

2. validate user's static access to tne new file. 

3. write out directory o.ntry of new file with uodated last 
reference date. 

4. validate access to ana allocate file if type ASCII. 

5. validate user's dynamic access to the file (use FUSS table). 

6. write out FUSS table with tyoe of access granted. 
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7. Fill in new information into file control olock. Adjust 
memory pointers if file buffer larger/smaller than that 
in this pos i t i on. 

fi. Return to the language processor. 



BSE 

The BYE routine is useo to log a user off. This routine may be 
called by the user as a command from his terminal or 
oronramat ical I y . by using the SYSTEM statement. 8YE is also 
called to log a user off when the IOP detects a disconnect on a 
oort. 

1. If there is no room in log table then reaueue the user at the 
lowest priority, restart at LIBRA. 

2. If the user had an *ouT=* file then Kill output. 

3. Clear output wait bit in the flag word if set. 

4. If 10 is zero, the user is not loaaed on. then go to IS. 

5. Clear ?PRIO ana 10. 

*. If OFCHK=0 then there ere no files that reauire their last 
change date ucoated. Go to 9. otherwise read in the user 
orooram and call LCO to no it. 

7. Release non-snarable devices user has in use. 

«. Remove the user from the I ock Queue » f he i s on i t . 

9. necrement the numoer of active oort count. 

10. Clear the user's f-USS table. 

11. Put delog off entry into the loo table. 

1?. Uncste the time used In the user in the IDT. 

13. S<»na a log off messane to the user via POSTR. If the IOP 
rejects the message RosTR will set the output wait pit in 
the- user's flag word and t?Ke the reject return. Otherwise 
qo to 16. 
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14. jf the messaae was not rejected ao to step lb. Otherise* 
loop to up to one minute while waiting for the output 

wait bit to oe cleared by a buffer free (6FE) from the ID* 3 . 
If timed-out go to step 1*>. If not ao to steo 13. 

15. Send a P0C to the iop in tne form of a Lf" to tne terminal. 
Tn I s is reguired by the ioP to force it out of an 
undesirable state. 

l<s. sena e hang user uo (huu) to the IOP. 

17. Clear and set tne unable to abort bit the user's flag word, 

IP. Clear main. 

13. Fvit to SCHt'3. 

C£I£LG<7 

The CATALOG command lists ell (or a line if called via the SYSTEM 
statement) of the programs and files stored on tne system of. a 
user. CATALOG lists, with three entries oer line* the entry 
name a pr ooram/f i I e aescriotor. an access restriction program 
flag, the lenatn and tne record lenoth. 

NAMP - the name of tne entry. 

PPOGPAM/flLE DEbC*lPTOW - A/F/m/C/BLAN.K ASCII FILE/FILE 

MWA FILE/CSAVED P^QG^AM/PPOGRAM 

ACCFSS PFSTPICriON - U/P/L/3LANK UN*tST^I CTED/PWOTECTED/ 

LOCKEO/PPlVATt- 

LEnGTh - the length in blocKS if a file or 

proqr«n» a device designator if it 
was a non-snar eab I e device. 

^t-CO^O LENGTH - print the record length in bytes for 

*n soecifiec device designator or 
in word for files *<ibb. 

The oDeration ot tne conmanri is as follows: 

1. ^et tre ?TEmh words to blanks 

?. Cneck if a startina entry name has been specified. if so. 

nut the name into the VTRMP words. 
3. Decrement the last byte of the name in ?TEMP nv one. 
^. If this was a cal I from tne System then uo to steo b. 
S. Get a buffer from louT and build the neadinq in it. Call 

LOUT to print it, 
f> . Move the user»s ID into LTEMP and move tne entry name 

in 7 TEMP into L"ItN.r> (:j). 
7. Get" a buffer from LOUT to build the catalog line. 
f». Call DL00K to finp the first directory entry oeyond the 



6-4 



one sought in (lHmp 0:3) • 
g. If the idcode of the new entry is the same as the one 
sought then go to steo 13. 

10. If the line contains at least one entry go to 12 to print 
the line and terminate. 

11. Fxit to the system statement clean ud routine if catalog 
was called from the language Processor, otherwise* 
terminate. 

1?. Set the successful write return in LOUT to terminate (LLENO) 

Go to step 18. 
13. Put the name* the orooram/flle descriptor * the access 

restruction, the length and the record length into the 

buffer for the entry. 
1^. If this is not the third entry on the line then go get the 

next entry. If there are no more entries then go to Id. 

15. »ut the ntsne of tne tnird entry on the line into ?TEMP« 

16. Set ud LOUT to move LTEmP (i:3) to ?T£mP words if the 
write is rejected in LoUT. This will insure that catalog 
will resume processing at the correct entry. 

17. Set the successful return of LnuT to steo 4. The fail 
return is also step 4. 

18. If cataloa was called from the language processor then exit 
to the system statement clean uo rout i ne (SYSCU) with the 

I i ne. 
1Q. Print the I i n** ana suspend. 



COM* 

The Chain routine is used by RA5IC to orocess a CHAIN statement 
in a user's oroaram. The function the chain routine is to find 
the oroaram named in the Chain statement* retrieve it from the 
disc* ana neain execution. it operates as follows: 

1. Oump file puffers. 

?. uranate the last chanq^d date entry in tne directory for each 
file whicn was written on. 

3. Translate name of proaram from CHAIN statement. Invalid 
names exit to error. If preceded oy a ,, V«« set up A000 
searrn; if oreceaed ^y ••♦"• set up group liprary search? 
otherwise sot for se=>rchino on user's 10. Save the line 
numper if any is specified. 

4. Perform directory search. fcxit to error if not found. 

5. C^eck to maKe sure that the entry is a program* that it is 
r.ot illstoreci* ano that it will fit. If an/ of these are 
not true* exit to the appropriate error. 
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*. donate oete entry in directory and write directory track 
o-^ck to nisc. 

7. ^ead in tho oasic oor t i on of the previous oroaram, including 
tne common area and then aopend the new program. If tne rean 
i s unsuccessful* read in the previous proaram aoain ana exit 
to error. If successful* move the new program name into the 
user's table* and if this is a run only program* set tne run- 
only pit* unless the program is in this user's own library. 
Call SEMic* which sets up pointers for tne language 
Drocessor* neoenaent upon whether the program is uncomoilec^ 
or semicompiled, Sf^ic also sets the "program unaltered pit" 
in the user's TTY T*ole. 

^. C^cck if an aoor t was attempted nurinq tnp previous steps* 
i*r\a if so* aoort tne user. 

9. ]i a I ine nunr.er **s specified* search the orogram for the 
statement anci* if fount, out its absolute address jnto 
t'POCT, If no line numoer was specified* set PRGCT eaua I 
to S p kOG. If the proaram is null* or if tne line number can- 
not be founct* clear the chain di t in tne flags word. In any 
case* exit to SChpl. 



CSav£ 

The CSAVfc routine is call en by a user to save a program in semi- 
compiled form. This is tne form it has after the svmpol table 
is du i I t , CSAVti operates I i kg SAVF with tne following 
excep t i on s , 

3. If oroaram is not conoileo then allocate common if necessary, 
charoe the user status to syntax* initialize some compile 
routine varianles anri enter the compile routine. Return to 
step 3a when pone co-u>i I i nn , 

3a, -Call &STPT to restore the symbol taole to its appearance just 
after it was ou i I t , westnre the user's status to CSAVE* 

c >. Check if proaram will fit in swao area (if tn« limit pointer 
(FILlr) Plus e> is £ LwAi'S)* if not Print PRO-AM Ton LARbh 
and exit, use this new 'value for spac<=» reauirements 
c a leu I at i ons , 

1<?, Kill in the six woros after the symbol tanle: 
1, symbol table pointer 

P., n 'of f i I e s tatement s in the program 

J-h the aadresses of these file statements 
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1^. Set the seniicoinci led oit in tne directory entry template 
(LTLmP+3* bi t lb) • 



QELEIE 

The DELETE commana allows a user to delete a section of his 
oroaram. He can specify two parameters? M and N. M refers to 
the first line to be deleted* N to the last. If N is not 
specif led* the entire oroqram i s deleted* starting at line M. 
The operation is as follows: 

1. Translate and checK parameters. If N is not specified* set 

It to 9999. 
?. Decompile oroaram. 

3. Locate ranqe of statements to be deleted. 
a.. Move portion of proaram followina deleted area up against 

oortion preceding. 
5. Peset PBPTk ana exit. 



DEVICE 

The DEVICE' command Prints a list of devices on the system the 
user may access a I end with the device's select code and status. 
The status Is n/a if the device is assigned to a name or to an ID 
not the same as tne user»s. It is busy if. the device is being 

used, 

1. Get the user»s IU7 entry and extract the caoaoility word Put 
into the first word of ?TEMP. 

2. If there aro no aevice table entries tnen terminate. 

3. initialize the device table entry-to-orocess pointer (stored 
in the 2nd wora of ?TEmp)" to the first entry of tne device 
table. Also initialize a pointer (3ra word of ?TEMP) to the 
ena of the device table +1* 

4. Print the t*o line neadina. 

5. Coov the ?TE<*^ woros to a three wora buffer (Pointed to by 
UDVTH) • 

6. Get tne device table entr v-to-or ocess pointer. If this 
oointer aces beyond the aevice tabic ( ?TF.mP + 1=?TEMP+2) then 
terminate. 

7. Get tne aevice designator from the device- table. If the user 
does not havp the access capability then bump tne device 
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table entry-to-process pointer to the next device entry and 
to to s teo S. 

p. Get a buffer from LOUT to build the data line. 

9. Put the device designator* the select code and the status 
into the buffer alonq with the record terminator (XQFF« 
C*LF) . 



10. Set one of tne parameters in the LOUT call to cause LOUT to 
swap ?TFVP with the i .worn nuffer Joointed to oy UOVTB) if 
the orint is rejected. This will cause the routine to 
restart processing at the right oevice table entry. 

11. Set the return adcress frcm LOUT to stpr S ^nd call LOUT. 



QIS-EClOfcX 

The DIRECTORY .allows a user on AuuO to list lisrary Proarams 
and files according to the user idcodes. The line for entry 
i nc I ude : 

ID - the i o code of the owner, Drinted only for 

the first entry of account 
NAMF - name of the program/file 

PUPGE DATF - the last reference date 
PPOG/FILt FLAG - A/F /'VC/BLANK ASCII F IlK/F I LE/F ILE WITH MWA/ 

CSAVEO PPOG/PPOG 
PROTECTION f-LAG - U/P/L/hLANK UNPHSTP ICTEO/PwO TECTEO/LOCKED/ 

PP-IVATE 
LFngTh - in dIock of prog/file 

OEv/AOOP - disc address if disc file or oevice designator 

if non-shareable device 
PFCLFn - include for files if its record length #dP6 

The ^Deration is as follows: 

1. Chec* if the userts iocode is AOUU. if not. print PRIVILEGE 
COMMAND ana exit. 

?. If a starting idcode has been specified then decrement the 
idcode by one and store it in ?PTIM. otherwise store 1 in 
?PTIM. 

3. Huild the system neadino consisting of the system id* tne 
date ana. the t me, 
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4. Try to outDut tne neadina and susoend. If the write was 
rejected go to 3, 

5. Trv to outout the directory heading ana suspend. If 
rejected ao to b. 

*. Set LTEMP with the ID saved in ?PTIM and LTEMP(1:3) to -Is. 

7. Set the orevious write f I ad to successful (0) and entry 
found flag to not founo (0). 

*. Call OLOOK to find the entry (in LTEMP 0:3) • Set the 
entry found accordingly. 

9. Get a buffer from lout to build a new line of tne directory 

10. If the previous write flag indicates the last write 
was successful then aet the next entry. 

11. save the new entryis idcode in ?PTIM. 

12. If the idcode is -l (psuedo entry) then terminate. 

13. Set bit lb of ?kTlM if the n*»w id code is not tne same as 
the idcode of the orevious entry (now in LTEMP). 

14. This forces the idcode to be included in the data line. 

15. Build the line of directory information. Include the 
idcooe if bit lb of ?&TIM Is set. Insert the entry name. 
T*e Program coae, tne protection code the lengtht the 
device/address and tne recorn lengtn. 

16. Put the entry name in the ?TEMP words. 

17. Try to cutout cne line and susoend. If the write failed* 
set the orevious write flag to fail (1) and do to step 19. 

IP. set previous write flag to successful (0) and clear bit 
15 of ?RTIH. 

1«. Set entry founa flag to not founci (0). 

P0. Move the idcooe into LTEMP from ?RTIM and move the entry 
to LTEMP (1:3) from the ?T£mP words. 

?], 6c to steo t. 
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Echo 

so^e devices* most notaolv tne teletype* hevc an independent 
Keyboard ana printer. The printer operates upon data from the 
computer only. In oroer to make it orint a typed character? the 
conouter must echo pack tne character. when tit let of a oort's 
receive channel parameter is set (eaual to 1)* tne port is 
operating in full oup I ex mode and the multiplexer will echo each 
character it receives on a hit by bit basis. 

the £Cr*o commend can be used to turn tne feature on or off. The 
commanc determines if the user wants to turn echo on or. off and 
sends to tne IOr- an t Cn or an FCF. The format of the command is 

KCho-on for full ,-jijo | ex 
fTCHO-OFK for halt auolex 



QIJmm user 

The OuN-P conmano c » I lo*s a user on AOoo to dump contents of system 
menorv* IOf memory* M>T and swan tracks. The format of the 
command. I s : 

DUMP-SYS [.STmKTIno wO^O) 
OUMf'-lOP .ItSTA&TlNG WOMO) 
OUMh-SWA [ »MOHT« 3 C •STaKTTNG wnwn] 
QUN'P-ADT 1*T*aCKr;| 

Tne OiiMp routine resides in two library overlays. The first 
overlay contains the routine to dump the system memory* the 
routine to cumo the swap tracks* and utility subroutine. The 
second cverlav« *nich overlays the first part of the first* 
contains the routine to -lumc tne iflP memory and the AOTs. The 
second overlay uses some of tne utility subroutines in the first 
overlay so it must ena oefore the usn routine of the first 
over I ay . 

The ooeration of .)UWP is as follows: 

] If the user is not on A'Juu then fail. 
£. Check if r>UM^ is enaoieo. If not* * a I I . 

3. Determine t-.e command desired. 

4. «ut the starting word* portr* or track* if one was 
specified m vl. ^ut u in VI if not. 

5. trench to tne appropriate routine* readinq in the second 
overlay if necessary. 
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SYSTEM_MEMORY_DUMP 

The contents of memory are listed. Eacn line consists of a five 
dialt octal address followed by eight six digit octal numbers 
each representing a location in memory. The user swap area 
cannot he * I i sted. 

l a Print the report headina consisting of the systemld* the 
oate and the time. 

?. Print SYSTEM PROCESSOR MEMORY 

3. Get the starting address (in Vi). 

A. If the adaress is beyond the swap area then set the 
terminal address (VA) to the end of memory Plus 
one. Go to steo 4. 

rt. if the address is in the swap area then set the starting 
address to the enci of the swap area plus one. Print 
SWAP AKLm CANNOT Bfe DUMPED RY USEP. Set the terminal 
address (vA) to the end of memory plus one. Go to step 
4. 

C. If the address is less than the beginning of the swap 
area then set the terminal address to the neginnlng of 
the swap araa m go to steo **• 

4. Get a buffer from LOUT and ou I I d a line in it. During this 
orocess V4 is set to the first location oast the last 
aoaress dumoea. 

5. If the line is null then the startinq address must have 
ooualed the terminal address (Vl-VA). 

A. If the terminal address Points to the end of memory Plus 
one then terminate. 

*. if the terminal address boints to the beginning of the 
swan trac* tnen go to 3b. This will print a message 
?,nd restart the listina after the swap area. 

*. Put CV4) thf> first location past last one on the Sine into 
?TEMP. 

7. Set up LOUT to move the starting address (Vl). into ?TEMP if 
tne print is rejected. 

H. Call LOUT to output the line and susoend. 

9. Restore the startina aadress (vlu from ?TEMP. 

10. Go to steo 3. 
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9yMP-y§£R_SWAP_TRACK 

The location from USt to ?PPO(? is listed for a oor t • 

I. Get the port # to start (Vd). Terminate immediately if not 
(0 <= port numoer <= 32)* 

?. Get the starting addrpss. If It is less than the beqinninq 
of the swap area then set the startina aodress (13) to USE. 

3. Determine if the oor t has ever been used. 

4. If port has been used then go to steo ♦- . 

5. Pump to the next oor t ana set VJ to USI- . Terminate if no 
more ports. Otherwise oo to 3. 

*. print Swap AWtM — popT XX. 

7. use v3 the starting aadress of the next line* to determine 
the aisc r-lock aadress of the location to oe dumped. 

^. I* the starting address is greater the ?PP0u then go to 
steo b. 

Q. Peed in two disc oIocks in case the locations to be dumped 
soan a disc b I ock, 

10. Get a buffer from LOUT and build a line of tne dump in it. 

II. output and suspend. 

1?. Go to steD 7 if the Drint *as rejected. 

13. If the print succeeded then bumD v3 until it is divisaole 
bv 1 Oh. 

U,. Go to step 7, 

QU*J£-IQfc_WEL-Q£X (resident on the overlay) 

The user may ootionallv sDecifv a startinq address. Tne routine 
has no way of deter m i n j na the size of the iOH memory so the dumo 
is set to terminate at location 7777/r. This means that for loPs 
with less than jeiK redundant information is dumped. 

1. print the reoort headino consistlnc of tne systemld* tne 
date ana the time. 

2. Put startinq address in V*. 
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3. Set maximum aaoress to the end of memory Plus one. 

/ 

4. Ask the IOP for eight words by sending a SCI then the 
address ( i n v/3) . 

5. Transfer the wora into memory at LIBD. 

6. If the starting address is eaual to the maximum then 
tern i nate. 

7. Get a buffer from LOUT to build a line. 

8. Print the line and suspend. 

9. If the write succeeded then bumo the starting address by up 
to e>. to maKe it divi sable by I OR. 

10. Go to step 4. 



QU£2£_5U1 (resident on the overlay) 

The system available aisc tracks are dumped five entries per 
line* a track at a time. The user may optionally specify a 
starting tracK number. 

1. ChecK if the track »<vi) specified is legal. Fail if not 

?. Print report heaping consisting of the syste.mid the date 
anp the t i me. 

3. Initialize the last seen disc address <V2« V3) to 
zeroes. 

&. if the track number is eight then terminate. 

5. Calculate the tracK length. if null then pumo the track 
numper (vl) to the next track and go to step 4. 

6. Print the message «U)T-TPACK ur\ . 

7. calculate the trac^< lenath again because it may have 
chanaed. If zero* ao to step <♦. 

*. *eaa in the aOT track into the user swap area at LIPUS. 

9. save a ooint^r to t*e entry to process in \/b. 

10. (-.et the last seen disc adoress in V3 and V3+1* 
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11. Search the al>1 track for the firs't entrywith a disc address 
areater then the last seen disc aaaress. Set V5 to point to 
the entry if founa. 

1?# I* the search failea* qo to steo lb. 

13. Get a buffer from LOUT to Put the outout in. 

14. Process the entry and out into the ouffer. 

15. If this was the fifth entry on the line qo to steo 17 to 
or i nt tho I ine. 

1^. If there are no more entries (thp entry just processed was 
the last one on the track) then qo to steo to orint the 
line if not null. If the line is null then bump 
vl to the next trac* and '?o to steo ^. 

17. Prepare the print by 

A. Put the tracrc number ♦ in v 1 « into \n+ 

«• Set the la-st seen disc address* no* pointed to by vb 

into Vb ano Vo 
C. Put V4. VS anq v6 into YTF^p to soscify where to restart 

the list after the write. 
0. Set LOUT to move VI • Vd and V3 into ?Th^P if the write 

fails. This win cause the line to be reoui It on 

return from louT. 

1*. Cell LOUT to output the line and susoeno. on return LOUT 
will transfer ?TtMP to V« Vc? and VJ. 

11, bo to step 7, 



EStC'JIt 

The Fxt-.CUTt commana allows tnp user to not ano run a Droaram. 

The operation of the commann is as follows: 

1. Decode name ana save if PFA is reouirea for the user to * 

access this oroaran. 
?. Search the directory for the entry. If it is not founa 

orint NO SUCH f-K0(iw*,,v and exit. 

3. If the entry is a file then crmt ENTh>y IS A FILE and 
exit. 

4. Check the program entry to see if the owner has PFA. If 
not and it»s required then print no SUCH ENT^Y and 
exit. 

^. if the program owner is the user then ao to steo 6. Other- 
wise checK if the oroaram is private. Print NO SUCH EnT^Y 
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• f i t i s • 

6. Check to see if there is enough room for the program. If 
it is too big Print PROGRAM Too LARGE and exit. 

7. UPdate the last reference date of the program's directory 
entry and wr i te the directory track out to disc. 

R. Read In the user swap area to PBUFF. 

9. Read in the program from disc* If the. read falls print 
UNABLF TO RETRIEVE FROM LIBRARY and exit. 

10. Set the protection t>its in the ?NAME words. Set bit 15 of 
the first wora if the program was locked, oit 15 of the 
second if private and bit 15 of the third If protected. 

11. Set the program owner wora (?PRID) in the user's TTY table. 
Set bit lb if the owner has FCP a^a is a group librarian. 

12. Call SEMIC to initialize compile var iaoles before compiling 
(see the GET command for a more complete description). 

13. Turn off the interruot system and set the HELLO flag in the 
user's flag word and change his status to RUN. 

14. set the user up to run for two seconds and set the time flag 
to time this user. 

15. jump to the compile routine. 



EILE-CQCDGeQfl 

Th*» f ILE command serves two purposes. First, it is used to 
associate a file name (and create a d irectdr*y en try ) w| th either 
a specific or a class of non-shareable devices. Second* it Is 
used to allocate space on the disc (and create a directory entry) 
for a disc ASCII file. 

1. hegjn building a directory entry by first extracting the 
orocosed name of the entry. 

? e setting the user's ?CLOC word to -1 will cause suspension of 
the user if the command was called progr ammat i ca I I y • This 
is aone to keep users who are progr ammat i ca I I y using the 
file command from tyino up the system. 

3. Fxtract tnc specified device desianator and the Proposed 
record size. Skid to steo 6 for ASCII disc files before 
netting the thira oarameter. 

4. Search the device taole for the device. Demand that the 
device is available on the system and that the user has the 
capability to access it. 

b. Insert the new directory entry in the orooer directory track 
(calling suDersave if the track is full) and update the 
DIkEC« IDEC» and Eouioment tables on oisc. Exit routine. 

6. For ASCII disc files* the next parameter is the file length 
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(in blocks). fcxtract it end the Possible record size (set 
to 63 if not present) and validate these two Parameters. 

Check that tnere is sufficient account space and enough 
system disc space to accomoaate the new file. Set disc 
address to appropriate spot on the ciisc and insert new 
directory entry. we don»t set read/write access pits yet 
because we don«t want user to have access before file is 
initial i Tea. 



update the account's 
space from the ADT. 



IDT entry and remove the necessary 



<->. oslno the user space* fill <*00 blocks worth of soace with 

FOF narks (user's have r<een known to Play tricKS to reaa IDT 
info from a baa I y created file). 

10. If more than a-00 slocks in the file* suspend with restart at 
disc initialization overlay (it lives in the mwa overlay). 
Otherwise* Give the user read/wr j to access by reading 
directory oack into memory and then terminate. 
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EILES 

The FILES routine is used by BASIC at run time to process FILES 
statements in a user's program. The function of the FILES 
routine is to translate the file names in the user's Program 
into file control blocks for use dur i no execution. 

Durina operation of tne FILES routine* a temporary buffer is used 
as a table to store intermediate data. Nine words of the buffer 
are used for each file. The operation is as follows: 

1. Translate characters in FILES statements into the buffer 

table. FILES statements are pointed to by a four word table 
in the user swap area which is oointed to by DFILT. FILCT = 
-5+ u of FILES statements. There may be up to 4 such state- 
ments. Filenames are extended to six characters* if 
necessary* and those which are specified to be system library 
are marked by settlna Hit 15 of their first word to 1. Those 
which are specified to be group library files are marked by 
setting bit 7 of their first word to i. A ••♦•• alone as a 
file name is a Place holder. The buffer taole for the 
entry is zeroed. Possible errors founo in this step arei 

a. File name of o or > o characters 
n. More than lfe files reauestod 

?. Perform directory search for each specified file. DIRWO 
points to the disc address of the directory track in core 
so that OLOOK ooesn't have to read and write tne directory 
for each file. iave the file's disc aodress* file length* 
and logical record s i ze in its portion of the buffer table. 
The read-only bit is set if the file is a library file and 
the user is not the owner. An error occurs if the file is 
nonexistent or protected. Update the last reference date 
woro in the directory entry for this file. 

3. Validate access to an-i allocate file if type ASCII. 

4. Test to maKe sure that there is sufficient room in the user 
area for tne file control blocks and buffers. 

5. Validate user 's aynam i c access to the file (use FUSS taole). 

6. write out FUSS tacle with type of access granted. 

7. Ruild file control blocks (see section on comoilation for 
format ) • 
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GEI-CQTDeoa 

The GFT command allows a user to get a program from the library, 

CO^AND FORMAT COMMENTS 

GET-NAME FULL ACCESS TO USEP»S OWN ACCOUNT 

GFT-$NAMF SYSTEM LIBRARY PROGRAM REFE'RENCEQ. PROG MUST 

BE UNR OR PRO 
GET-*NAME GROUP LIBRARY PROGRAM KEFf- kENCE'I). PROG MUST 

bE UNR OR PRO 
GFT-MAMfrD.ID RbUUlPfeS OWNER HAVE PFA AND USER MUST HAVE 

STATIC ACCF.SS TO OWNER'S ACCOUNT 

1, nococie name ana note if program will nf-co PFA, Leave ID 
ana name in LTEmP o-"*. 

?• Search for entry. Print no SUCH PROGRAM if not found, 

3, If file then print ENTRY IS A FILE and exit. 

a. if the entry aoes not neve PFA gut is reauirea Print NO SUCd 
PROGRAM ana exit, 

S, If the user owns oroaram aoto H, 

ft. If the program is Drivate print no SUC»-» HK0G-1AM and exit, 

7, If the program is locked print EXECUTE ONLY and exit, 

P, Check if the proaram will fit into the user rir^a. This is 
necessary in case * oroaram that was savpi under an o I d 
version of the system can no l onaer fit with the current 
version. If it is too ma or int PP0G*a*i Too LARGE and exit. 

9, uooate the last reference date of the directory entry and 
wr i te hac* to cisc, 

10, wefld in swaooable base paae, 

ll,. Pead in tne program neainnmo at the starting address 

specified in the directory entry. If tne disc transfer 
fails then orint- HNA»lF TO RETRIEVE FROM LIBRARY and exit, 

I?. Move the name of tne oroaram from LTEmh+i to LTEMP+j into 
the ?namp woras in tne user's TTY taole entry, 

13, Set bit 15 of the first wora of ?NAM£ if tne program is 
locked, the second wora if private anc tne tnird word 
i f protected. 
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]£.. Put owner's ID* from L.TEMP + 0* into ?PRID in the user's TTY 
table. 

15. Call SEHIC which will for uncomojled programs* clear QFLAG* 
SYMTe* reset PfcPTR to the end of the new orogram* clear 
the compile bit in the user's TTY taole* set main and set 
SPROO. For a compiled program SFMIC will set PBPTR* and 
F1LT6 to the ena of the program -6. SEmIC then moves the 
first word of the six after PBPTR to SYMTB; the seeondt 
the file statement counter* to FILCT; the next 4 words* 
file statement pointers* into FLSTs+O to FLSTS+3. Then the 
compile bit in the user's TTY table is set, MAIN is set and 
SPkOG. 

16. r^lock the clock and initialize common if any* from PBUFF to 
SPfcOGt with -1 »s. 

17. Fxit. 
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btLLO 

Tr»e Hf.LLO commend is used to Jog a user on the system. its 
operation is as follows: 

1. If the current lo is Of there is no user to log off* so go 
Step <f. otherwise* tell the I/O processor (service routine 
NUC) that a new user" called. This will force the user to 
be disconnected if he does not successfully log on. 

2. Reao the IDT. If there is no user to be logged off* go to 
Step o. If user has *0UT=* file then remove it. 

3. oecrement the numoer of active ports by one. 

4. Find the old user's idt entry and update his total time 
usea. Ada an entry to LOGbW to pe printed on the system 
console. Set tne user's ID word to 0. 

5. Translate the new Id code and search for it in the IDT. If 
not found* print an error message and terminate. compare 
the password typed to the correct one* and fail if they 
disagree. 

6. Check if a terminal type was input. If not* assume terminal 
type #0 and go to step ?• otherwise check if terminal 

type is in the Range through a. If hot orint an error 
message. 

7. Tell I/O processor (service routine STP) which terminal is 
connected to the Dort. checK that the time used to date 
is less than the time allowed. 

h. Check if user has anytime left. Fail if none left. 

9. Initialize CofLu oit in user's tty table ?FLAii word to 0. 

10 Ada a LOGON entry to LOGGk and set the starting time into 
the- user's TTY table. Also insert the ID code* clear 
name* scratch the program. Tell the 1/0 processor of 
the successful Logon (service routine ULO) • 

11. Increment tne number of active ports by one. 

12. print banner message if present. Ignore If it can't be read 
read from disc. 

13. Search the airectory for a program named H6LLO in the 
library of user AOOu. If not found* or if it is a file* 
or if It will not fit I n core* or if it cannot be read 
from disc* print READY and terminate. 
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14. put name into ?n»ame + to ?NAME+<i in user's TTY table. Set 
bit lb of first word locked* second if private and third 
if protected. 



15. 
16. 



Set ?PRID with program owner's ID 
al so set pi t 15. 



If owner has FC8 then 



Read in the fixed user area and append hELLO. Call SEMiCt 
which sets program pointers as in SAVE. Change the user»s 
status to RUN, set the chain flag* issue a LF* and transfer 
to BASIC. 



eu&GE Command 

The PURbfc command deletes a directory entry (program, file, disc 
ASCII file, or non-shareable device) and returns any space 
occupied by that entity to the system's AUT . The overlay can be 
invokea by a command, a BASIC statement* or some of its 
subroutines may oe invoKed directly from other overlays. 

1. If called programmat ica I ly * skip this step as BASIC has 
already saved the entry name and owner's id in LTEMP (0:3). 
Otherwise, extract entry name and save in LTEMPs. 

2. Force the user who programmat I cal I y invokes the command to 
be suspended at command completion by setting ?CLOC to -1. 
This keeps users doing a lot of sequential PURGES from 
tying up the system. 

3. If called programmat i ca l I y and If it passes necessary 
criteria, allow a group master to purge a group member's 
locked BASIC formatted file. 

4. Find specified directory entry. For files ensure that the 
entry is not in use. 

5. Delete entry from directory track. Terminate routine if 
no space is to ee returned to system. 

6. Return space to mot and update owner's IuT to reflect lost 
space. Update memory resident tables on disc (0IREC» IDEC 
and tduipment lable). Exit routine. 
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LE&Gltl Command 

The LENGTH command prints the length of the user's program? in 
both woros and disc records* tne total disc space currently used 
in the account and tne total disc space permitted* " This command 
may oe called programmt i ca I I y by using the SYSTEM statement. The 
ooeration is as follows* 

1. keaa in program so we can access swappaole base page 
var i abl es . 

d m The length of an uncomoiled Program in words is 7PROG-SPKOG. 
?PP0G Points to tne last word if the program +1 and SPkOG 
the beginning. For a compiled program the length in words 
is SYMTb-SPkOG» SYMTb is the start of the symbol table which 
just follows the proaram. The lengtn in records is the 
integer part of tne sum of the lengtn in words Plus 255 
divided by ibb. 

3. convert the length in words and records into ASCII and put 
into output buffer. 

4. Reao in the IDT entry of the user to get tne total space 
useo (records) and the total allowed, convert these to 
ASCII and also Put into the output buffer. 

b. If LENGTH was not called orogrammat i ca I I y then go to step 

b. otherwise move the output buffer to f iLbF so the SYSTEM 
overlay may be oroupnt in. Exit to tne language Processor 
(SYSCU). 

6. Print output buffer and terminate. 



Llabattt 

The LltN^kY routine prints a list of all programs and files in 
the Public library. its operation is identical to that of 
CATALOG except tnat AuuO is used for directory searches instead 
of the user's id» ana protected programs are not listed. 



GBQUe 

The GWOUP routine prints a list of all programs and files in the 
user's group library (tne liorary of the lacoae ending in Ou 
whicn has the same letter and first number es the user). Its 
operation is identical to that of LIBRAKY except that the group 
librarian's ictcooe is used for directory searches instead of 
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AOOO. 



Lisizeuuctj 

The LIST and PUNCH commands are called by the user to LIST or 
PUNCH the program currently In core on the' user is terminal • The 
In-core executor sets LTOsO (LIST) or LTOs-I (PUNCH). 

1. If the program is nu I I • terminate after printing a 
I ine-f eed, 

2. Evaluate the Beginning and ending line numbers and determine 
whether the pagination option was specified. 

3. A aummy file control block Is established for the output 
device. If ♦OUls* was specified* the block is initialized 
from the parameter ?OPfcC in the user teletype table, other- 
wise it is set up for the user terminal. In either case* a 
buffer is allocated and the SPACQ bit is set in the user 
teletype taole to indicate that the buffer is allocated. 

4. The paginator flag is cleared if the output device is ASCII. 
If the commana is PUNCH* a. check is maae that tne output 
device is either the user terminal or a paper tape Punch. 

5. output the program name followed by an emoty line. If In 
the PUNCH commana output feed frames for leader. 

6. If at end of program* go to step 12. otherwise get the 
line number ana Place in .LNUM. If this line is past the 
end line number, go to step 12. If a new Page is required 
for the pagination option* outDut the required number of 
line feeds. Flag first position operator. 

7. If at ena of statement* print the current line and go to 
step to. Otherwise go to step 8. 

8. Extract next operator. If null qo to step 9. If the first 
oos it ion operator flag is set then output the multicharacter 
operator (including the rest of the line if REM* FILES* or 
IVAfcE) and go to steo 7. If the operator is single quote 

ao to step 11. if the operator is a single character* out- 
put the character and to to step 9. otherwise output a 
multicharacter operator ano go to step 9. 

9. extract next operand. If the constant flag is set* go to 
step 10. If null go to step 7. If program is compiled 
retrieve actual name from symbol table. If the operand is 
an. extenaed string output the letter* digit (if present)* 
and $ and go to step 7. If the operand is a user defined 
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function output FN followed cy the letter and go to step 7. 
Otherwise output the letter followed by a digit (if present) 
or a $ (if a simple string variable). Go to step 7. 

10. If the operana is a numerical constant* output the number 
and go to step 7. If a pre-aef Ineo function print the name 
ane go to step 7. If parameter symbol orjnt it and go to 
step 7., The remaining case is that of a program integer. 
If within a DIM or COM statement output the integer and 
and go to step 7. otherwise output the integer statement 
reference. If ot the end of the statement print the line 
ano go to t>. if not at eno of statement but within a 
USINu go to step a. otherwise we're in a computed uoTo 

so emit a comma and Keep printing program integers until 
statement eno is found then go to step c. 

11. List a string constant* prefixed ana suffixed by single 
quotes. uo to step 7. 

I'd* output trailing feed frames if PUNCri* write LOf if *ouT = * 
to ASCII disc file* ae-f»l locate buffer* reset the SPACG 
nit* output a iine-feeo ana return. 



LQ&Q 

The LOmu command allows the user to inout a urogram from an 
ASCII file. 

1. Clear carriage return flag of lChap. 

d. Mock the ciock so main can be cleared ana the user &r&& 
written out to disc. 

3. Decooe filename and record if PFA is required. 

4. Search for the file. If not found print no SUCH fcNTPY and 
ex i t . 

bm If HKA is required but file owner does not nave the cao- 
aaility* print No ACCtSS ALLOWED and exit. 

6. Call stCh* to Check if user has static access to file 
owner's account. If not* then print no aCClSS ALLOWto 
and exit. 

7. Call AFILL to find if the file is ASCII* tne file not busy 
and the user has the capability to access it.. If not* print 
an error message and exit. Set ?0«LC* ?ouTp* and VNWEC 
with appropriate values if the checks succeed. Also update 
last reference ana chanoe date of the file and write out 
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directory tracm. 
B. Read the user program back into core and set MAIN. 

9. initialize syntax variables and decompile Program if 
compi led. 

10. Check If there is enough space left in the user area for a 
device buffer (=record length) ♦ and a FCb (11 words), 
print OUT OF STORAGE ana exit If not. 

11. Turn off the interrupt system and check the user's status 
word. If %AbKl tnen exit to scheduler (SCHL). 

12. Set the unaole to aoort bit and set the tape mode pit in 
the user's ?FLau word. 

13. keenable interrupt system and unblock the clock. 

14. Move the user program into higher core so the FCB and the 
oevice buffer may oe placed at PBUfF. 

lb. Set IhfIL Point to the FCB and call STFCb to fill the FCB. 

16. Get a record from LINRQ. If EOF detected go to step 21. If 
tne recora does not start with a digit then susoend by set- 
ting ?PLEV to <♦ end restart to step 17* requeue and enter 
the scheduler at SCMi. 

17. If the abort attempted bit is set then go to step 21. 
IP. jump to syntax to process the record. 

19. on return* suspend if the ascli file was not a disc file. 
Restart at step 16. 

20. If the disc records in core have been exhausted then 
suspend restarting at step lb. otnerwise get a record and 
go to step lb. 



The following steps describes the clean up necessary before 
exi t i ng : 

21. Set INFIL to zero and remove the FCb ana device record 
buffer from the user swap area* 

22. Adjust PBPTk. 

23. Clear the unable to abort and the abort attempted bits in 
tne users flag wora. 
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d<+* ki II the ascii input device. 

2S. Clear the tape made pit. 

«?6. I* tne taoe error bit was set then go to steo dl to schedule 
the tape moae cleanup routine. otherwise terminate. 

The following step schedules the tape moae c I ean— up routine. 

27. block the cIock. 

?8. Set the restart address to the beginning of the tape mode 
clean-up routine. 

?9.° Set tne the user or ionty to <♦. 

30. Set the status to tape mode cleanup unless the user status 
i s a Ireaay %01SC • 

40. Dequeue the user ana reaueue at the bottom of the aueue. 

50. fenter scheauler at SChl. 

MESSakt 

The Mf-.SbMbfc commano is used to send a message from a user console 

to the. system console. The message is Placea in a aueue* ana Is 
ultimately output to the system console by the scneauler. The 
routine* operates as follows: 

1. Check if message aueue is full. If so» fail. 

2. Put a CN-LF ana tne ASCII representation of the user's port 
numoer in tne message buffer. 

3. Transfer the messaoe from the user's teletype puffer in the 
I/O processor to the message buffer one character at a time 
(ignoring characters <4U(d) and >177(d) except oe I I 7(d)). 
btop when C* encountered or after fd characters transferred. 

4. increment message counter ana set pointer to next message 
nuffer, 

5. Term i note. 



»This is a circular aueue maae up of five J9 word buffers. 
Relevant variable incluae. MSuCT* a positive count of full 
buffers* MSUP3* which contain the address of tne next ava.i laoie 
buffer* and MSuHi* a Pointer to tne buffer being processed. 
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The name command allows a user to assign a name to his program. 
The program name is Placed In his teletype table. Tne operation 
is as fo I tows* . 

1. Get a character. if it Is a carriage return than change It 
Into a blank. 

2. If tne character is not a blank* letter or digit then zero 
name area* while Preserving the protection bits* and take 
the illegal format exit CILFEW) . 

3. Save the character in the NAME words of the user's TTY 
table* ana keep protection bits. 

4. If less than e> characters go to step 1. 

5. If first word is blank then zero the word except for the 
protection oits that are set and get another input 
character. If the next character is a carriage return then 
exit, otherwise output the warning message "ONLY 

6 chaRACTEhs ACCtHTED" before exiting. 



Ctf£&It Command 

The CREATE command allocates space on the disc for a BASIC 
formatted file* gives it a name* and creates a directory entry 
to ooint to it. The space on the disc is initialized with EOF 
marks to Keep clever users from being able to read any left over 
tables that previously occupied memory. The overlay can be 
InvoKed by either a system command or by an executing BASIC 
prooram. In the latter case BASIC sets up the Parameters In a 
directory template (LTEMP0..11) ana sets SYSFL. 

1. If called Programmat ical I y * continue at step 2. otherwise* 
extract prooosea file name* file length, and record length 
(optional Parameter). Save in directory temoiate (LTtMPO.. 
11). 

2. Set ?CLOC wora in TTY table to -i' so* if called program- 
matically. user win oe suspended at eno of routine. This 
Keeps users from inordinately tying up the system. 

3. If name is Qualified* aemana that 1) we were called 
progr ammat i ca l I y * 2) user is a group master* 3) user has 
FCH capability* and *♦) potential owner id has PFA. 
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4. verify sufficient soace exists in account and system. Set 
disc address of space to be removed from ADT • 

5. insert new directory entry in the proper directory track 
(calling sgpersave if necessary). update owner's IDT entry 
and remove space from AOT. Note that this order is 
important in the event of either being unable to insert 
directory entry or unable to update IDT entry* In these 
cases 9 no space has been removed from the ADT yet. 

6V initialize file with EOF marks. If more than 40 records* 
suspend user with restart at disc file i n i t i al i zat ion (MWA 
overlay resident). When done, read bacK directory and 
give user reaa/write access. 

7. Note that DIKEC* IDEC* and Equipment Table are updated on 
the aisc as necessary. 



USBESI&ICI 

The UNfcESTRICl command allows a user to unrestrict a program or 
file. An unrestricted program allows any user having static 
access to the owner is account to uET* EXE or CHAIN to it. An 
unrestricted file allows any user having static access to the 
owner's account to read/write on it (subject to dynamic 
restrictions). The operation is as follows. 

1. Check for legal name. output an error message if not. 

Search directory for program/file, output an error message 
if not found. 

3. Clear bits 0J3 in the status word ana set bit 0, the 
unrestrict bit. in the directory entry. 

4. write the directory back out on disc and terminate. 

btiuIECl 

The PROTECT command allows a user to protect a program or file. 
A Protected file allows any user having static access to the 
file to read it. A protected program allows any user with static 
access to the owner's account to EXECUTE* CHAIN to or GET the 
prooram out not list* punch or save it. The operation of PROTECT 
is the same as UNttESTklCT put 
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3. Clear bits 0-3 in the status word and set oit 1* the Pro- 
tect bit» in the directory entry. 



LOCK 

The LOCK command allows a user to lock a file or program. Any 
user having static access to the owner's library may EXECUTE 
or chain to the- beginning of the program. a locked program from 
the owner's program owner's account may CHAIN to other than the 
beginning of the locked program. Any user having static access 
of the owner's library has read/write capability while executing 
a locked program from tne owner's account. The operation of the 
LOCK command is the same as the UNPESTPICT except: 

3. Clear bits 0-3 in the status word and set pit d% the LOCK 
bitt in the directory entry. 



The PRIVATE commano allows a user to place a file or program 
in the private state. A file or program in the private state 
may not be accesea by anyone but the owner. The operation of 
PRIVATE is the same of UNRESTR1CT except. 

3. Clear bits 0-3 of the STATUS worci and set oit 3 the private 
bit* in the directory entry. 



Sti£ 

The Swa command allows a user to Place a file in the SWA state. 
A file in the Swa state restricts write access to the file to. 
at most one user • 

The operation is as follows: 

1. l?et ano checK for legal name specified. If not* output an 
error message ano exit. 

2. Search the directory for the directory entry. output an. 
error message if not found or i f a program and exit. 

3. Clear Mwa bit in the entry if set. write the diectory back 
out to disc ano terminate. 
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The MWA command allows a user to Place a fire in the 
mul t iple~wr i te access state. This permits simultaneous access, 
to the file (subject to aynamlc restrictions) by any users who 
has static access to the owner's library, only users with the 
MWA capability may execute the MWA command. Tne operation is 
as fol lows: 

1. Check and save the parameter list of the command. If 
bad output a message and exit. 

2. ChecK If the user has MWA. If not* output a message and 
ex 1 1 • 

3. search directory for the entry, output an error message if 
not found* a program* or an asci t file; exit. 

4. Set MWA bit in entry* write back out to disc and terminate. 

ecogcamatlcttttA 

A file may be made mwa programt leal I y by the use of the SYSTEM 
statement to execute the MWA command. 

1. . Check and save the Parameter list of the command. If bad 

set return coae to fall and exit. 

2. Note if the file to be MWAed has been dual if led 
(f i lename.iO) or not. 

3. Check if the file owner has mwa. If not* set return code to 
fai I and ex! t • 

4. search for the file. If the entry turns out to be on ASCII 
file or a program then set the return code to fail and exit. 

5. Set the mwa bit in the files directory entry. 

6. If filename was not qualified then go to 7. otherwise check 
if file is locKeo* file owner has PFA* the file owner is in 
the group of the program running and the orogram owner's id 
is a group master. Print an error message and terminate If 
any of the eneexs fai lea. 

7. write out diectory tracK and exit. 
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The pause statement allows an executing program to suspend for a 
period of time from l to 3«f7b7 seconds. The user Is suspended 
with the %PAUS status until the time expires or the console 
awakens him with the awake command. 

1. If user typea in pause as a command then terminate. 

2. Negate the time specified by the user and put into ?RTIm£. 

3. Clear the user's unaole to abort bit so the user may preak 
unless the ne had aisabled it <PoFLG=i). 

«.. Set the user's status to pause ana suspend with the restart 
aoaress set to pmurS-1. when restarted after the time has 
elasped or awakened by the console* the program enters* with 
(b)=U indicating success* the system statement clean up 
rout i ne . 



BENUBetb 

The function of RENOMbER is tc assign a new set of sequence 
numbers to a user program. The user may specify the sequence 
numper of the first statement and the increment between 
statements. If unspecified, these are set to iO. He may also 
specify the first statment to be renumoerea and tne last 
statement to be renumbered. If unspecified tnese are set to the 
first statement of the program ana the last statement of the 
program respectively. 

There are actually two sets of numbers that must oe modified. 
One set is the sequence numoers themselves* each of which 
occupies the first word of its statement. The other is the set 
of references* which are labels in CONVERT* bO To* GOSUH* 
RESTORE * PRINT uSlNb. mat PRINT USING* and IF statements. Each 
of tnese also occupies one word. For programs in compiled mode* 
thev are pointers to the statement they reference* In decompiled 
mode they are the actual statement number. 

The primary technique used is to change all the references to 
absolute pointers (if in decompiled mode)* then to change all the 
sequence numbers* ana then (if in decompiled mode) to change the 
references to the new statement numbers. References to 
nonexistent lapels are left unchanged. 
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Because the process of changing all the references to absolute 
pointers can become quite time consuming (due to the search that 
must be performed for each reference) 9 a table is built in 
advance aiviaing the Program into Jd parts* each containing the 
same number of statements . For large programs with many 
references* this effectively cuts the time aown by a factor of 
33 . 

The subroutine RENSK is usea to scan for references. It 
maintains two pointers, RENP and RENQ. Whenever it is called* 
it moves RENP to the next reference* and sets RENQ to point at 
the statement following the one that RENP Is pointing at. It 
taKes advantage of the fact that any references within a 
statement are always the last wora or words of the statement* 
except in the case of PRINT USING and MAT PRINT USING* in which 
case it takes advantage of the fact that there is only one 
statement number reference. All PRINT and mat PRINT statements 
are scanned until either a USING is found or it is determined 
that no USING is in the statement. If a USING is found* a check 
is maoe for tne statement reference. Before calling RENSK for 
the first time. HENU is set to point at the first statement to be 
renumbered. RENP is set RENQ-1. 

The ooeration of renumber is as follows; 

1. -If null program, terminate immediately. Otherwise* read In 

user program. 

2. Perform statement length check on ail statements in program. 

3. Translate and check parameters M and N. Set to default 
values if not present. 

4. Translate parameters P and 0. Set RENBA s first statement 
to be. renumpereof RENLA to last statement to be renumbered. 

5. Set kENLA to point to the last seauence n £ RENLA. Also set 
RENBA to point to the first seauence # * RENBA. 

b. Insure that tnere will be no sequence number overlap at 

either end of the portion of the program to be renumbered 
ana that the new seauence numoers will not exceed 9999. 

7. If program is in compiled mode* go to Steo 10. otherwise* 
set up a table in t^SEC whcih divides the program into 3<e! 
parts. The result is that for each I from to 31: 
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ERSECC1) = sequence number of first statement in pert 1* 
ERSECCI+32) = aosolute address of that statement 

If there are 32K «■ l statements (0 < l £ 31) in the program* 
ERSEC [I) is the seauence number of statement: 

(K + 1)*I + li IM < L 
K»I + L + 1» If U Li K ^0 
Undefined if I * L* K=0 

Set RfcNQ=SPROU» RENP=R£NQ-1. < SPROG 
points to the first statement).. 

8. Call RENSK to find the next statement reference. If there 
&re none left* go to step lo. Find the largest I for which 
ERStC CIJ £ (KENP) . if there is none* the statement 
referenced does not exist* so go to step 9. otherwise* test 
all statements from (ERSEC CI + 32} to either (ERSEC CI ♦ 
33)) or PBPl'R* depending upon whether I < Jl or I s 31 • If 
found* set (RENR) to the location of the statement referred 
to* and repeat this step* otherwise* go to step 9. ' 

9. Set (RENP) = (KENP) + 10000u(d) and go baCK to step 7* 

10. Change the seauence numbers for all statements to oe 
changed* according to the RENM* RENN* RENoa and RENLA 
values. If complied mode* terminate. otherwise* set RENO s 
SRKOG and rtE.NHsfcfc.NQ-i. 

11. Call RENSK to find the next statement reference. If none 
left* terminate. if (RENP) < o* the reference was 
undefined* so set (RENP) = (RENP)-iuuouo (6) » and repeat 
this step. 



BEKQBI User Console 

The REPORT command allows a user on AUUO to list user IDT 
information. Each user ID is listed along with the time* 
disc usea* its capabilities* ana its device designators. The 
routine LOUT is usea for listing to the terminal. This routine 
will suspend the user after each line. 
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The operation of the command is as follows: 

1. Check If the user is on A000. if not* Print PRIVILEGED 
COMMAND ana exit. 

2. Check If the user specified an 10 to start with. If so* 
save it in the user's TTY table ?RTIm word otherwise save 
a nu I I • 

3. Print the first two lines of the heading. 

4. Get the ID cooe from ?RTIM and search the ID tracks for it. 
If the ID coae is areater than any on the system then 
terminate. If the ID code is not there* then choose the 
next one. 

5. Builo the line in FlLdF* for the ID consisting of the 
iacode its time usea* its disc space used* its capabilities 
ana its device designators. 

6. Check if the ID is the last one on the system. If so* set 
the return from a successful write to LEND otherwise set 
to step 4. 

7. Try to output the line. If unsuccessful tnen go to 4. If 
successful exit to LLEND if there are no more IDs* otherwise 
bump the ID in ?kTIM then go to step 4. 



SAVE 

The SAVt routine is called by the user to save a program 
(uncompiied from SPRQO to PBPTR) in library. 

1. Test for the existence of a program name and a non-null 
program. Print no PnoGRAM name or NO PROGRAM if not and 
exit. 

2. Peso in user program from swao area* 

3. If program is compiled then decompile it. Allocate common 
if any. 

a. write the program out to the swap area* 

5. Allocated to LSAVE for numbering compat i oi I i ty . See CSAVE 

6. compute tne sPoce required to save the program in negative 
woras ana positive recoras, Put the negative word length 
into the directory entry template (at lTEmh to LTEMP+H) 
lenath wora. Save the recora length for the ADT search 
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I ater • 

7. Get user IDT entry. ChecK the user capabilities and set the 
PFA and F CP bits in the directory entry template 
accordingly. Also the set private bit. 

e. If there is not enouoh space left in tne user's account then 
orint LIBRARY SPACE FULL and exit. 

9. search the AQT for the space. in the process any ADTs 
encountered that could not be reao because of disc errors 
are oeleted from tne system (length = and the disc 
address =0). If the search fails print SYSTEM OVERLOAD 
and exit. 

10. Save the AOT aisc address* the position on track of the 
entry* ana the space remaining after tne program space has 
been allocated. Put disc address of the space into the 
directory entry template aisc address word. 

11. Read the program oacn in from the swap area. 

12. For CSAVE only. 

13. write the program out (from SPROG to PbPTR) to disc. 

If unsuccessful because of aisc error the go to steo «J0. 

1*. Move name from 11 y table (x»NAME) to the directory entry 

template (LTEmp 1:jj* stripping protection bits if present. 

lb. See CSAVE. 

16. Search for a auPlicate entry. If founa* orint DUPLICATE 
ENTRY and exit. 

17 If the directory tracx that the new entry is to go on is 
full- then call tne SUPERSAVE routine to redistribute the 
directory. suPtRSAVE will perform step la and proceed to 
steo 19. if SUPtRSAVE fails then print SYSTcM OVERLOAD and 
exit. 

lft. Fill in the start of program pointer, the last reference 
date and the last change date in the directory entry tem- 
plate ano insert into the directory. 

19. Read the user's IDT entry ana update the disc space used. 

20. If tne AOJ tracK lengtn is zero or the aoT could not be 
read from disc then go to step dl. Update the ADT and write 
it out again. 

21. If tne program was successfully written to tne 
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library then update the system tables (EGT. DlKfcCt IDEC) 

on disc, 

22. If the writer of the program to the user's library had 
failed then, print UNSUCCESSFUL* TRY AGAIN. 

23. Terminate. 



SUe£BSeUE 

The SUPERSAVE routine is called by the SAVE* CSAVE* COPY* BESTOW* 
FILE and CREATE routines when they want to make a directory entry 
on a track that is already full* SUPERSAVt assumes that the 
following woros are set properly: 

(LTEMP:LTEmP+3) = first *• woros of entry. 

(LTEMP+4) = pointer to DIRtC entry for appropriate directory 

track 
(LTEMP+b) = core address of entry which i s to precede the 

new entry 
(LTEMP+6:LTEmP+7) s aisc address of entry 
(LTEMP+6) a length of entry 
(LTEMP+10) = start of program po iner/r ecord size 

Note that (LTtMP+4) and (LTEmP+S) are set correctly by 
ULOOK. 

SUPERSAVE attempts to redistribute the directory tracks so that 

they will be as equal in length as possible. This will generally 

Prevent it from being called very frequently. Tne operation is 
as f o I lows : 

1. Scan through DIRtC and determine tne total length of all 
directory tracKs, and add 12. for the new entry. If all 
directory tracKs are full* exit through failure location. 



2. 



Divioe total directory length by numoer of available disc 
tracks to determine their new individual lengths. Insert 
these in the table at (DEFNN+1 :DEFNN+aO ) as negative. 



3. now squeeze all the directory entries to the last most of 

the available tracks. This is done by reading the tracks in 
reverse oraer ana writing did** words on each track until we 
run out of directory entries. The following variables are 
used in this section; 

SuRKl points to the DIRtC entry for track being read 

(initially DIREL) 
SUPL1 Points to the DXREC entry for track being written 

(initial ly DIREL) 
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SUPK2 = -# of words in core 

4. if (# of words on track SUPK1-SUPK2) > dlb4» go to b. 
Otherwise upoate SUPK? ano read this tracK to the core 
buffer at location LULEN + SUPK2 (SUPKd being negative). 
If SUPK2 n -B1B4, go to 6. otherwise set tne length into 
the SUPL1 UIPEL7 entry ana write the dlb<* word buffer to 
track SUPLI. Set SUPK2=0 ana go to 7. 

5. Set SUPES = (*of words on track SUPKl-SPuK2-BlB4) /2bb. That 
is the numoer of extra blocKS on the tracK to be read. 

Set SUPEX = SuPhS * efbb. This is the numoer of extra words. 
Then read the last (* of words on tracK bUPKi-SUPEX) words 
from track SUPK1 to location (LULEn + SUPK2 -• * of words 
on track SUVK1 + SUPEX ) ana update SUPK2. 

ft. write B1B4 woras to track SUPLi from location LULEN-ald* ana 
set the length in the SUPLI DIREC entry. Move tne leftover 
-818<*-SUkK2 woras to the end of tne puf fer # reset t i ng SUPK2. 
Then reaa the Supex woras left on tracn SUPKl to location 
LULEN+SUPK2-SUPEX. Set SUPKii=SUPK2-bUPb.X . 

7. upoate SUPLI to Point to the next track to write. 

B. UPoate SUPKl to Point to the next track to read. If we»v© 
finished all tracKS* to to **. otherwise go to <♦. 

9. If bUPK2 s 0* go to 10. Otherwise write out the -SUPK2 
words to tracn SuPLl ana set the lengtn in tne SUPLI DIkEC 
entry. 

10. lero out tne lengths in the UIPEC table of all those tracks 
that no longer have anything written on then. 

11. mow redistribute the airectory tracKs. Tne oasic i aea of 
the algorithm is to fill the swao area with as much of the 
directory information as we can» reading from the beginning, 
and then to write out as much as we can* always making sure 
that when writing we don't overlay any portion that hasn't 
been reaa yet. The following variables are used: 

SUPrvl Points to the DlktC entry for tracK being read 

(initially uihECO) 
SUPLI points to the OIPEC entry for tracn being written 

( mi tal ly ulktco) 
SUHK2 s # of woras reaa so far from tracK SUPKl 

(initially o) 
SUPLi? = # of woras written so far on tracK SUPLi 

(initially 0) 
SUP = * of woras in core 

(initially u ) 
SUPP points to uefnm entry* telling how many are to be 
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written on SUPLl. 
SUPTG =1 i f we have already Insertea the new entry. 

12. If SUPL2=-(SUPP) * we have completely written tracK SUPLl so 
checK for SUPLl = DIPEL. If it is* we've written all the 
tracks* so go to steo la. otherwise* aavance SUPLl to the 
next Directory track advance SUPP* set SUPL2 = 0* and repeat 
this step. If SUPl2=(SUPP) go to step 13. 

13. If SUP 2 10232* we have read as much as we can* so go to 
step 15. If SUPKl s DIREU* there is nothing left to read* 
so go to step lb. If SUPK2 =s n of words on track SUPKl* 
we've read the entire track* so advance SUPKl to the next 
track* set SUPK2 = 0* and repeat this step, otherwise* 
compute the number of words we can read. If there is no 
room to read the balance of the track* we will* otherwise 
we will read the maximum number of full blocks possible. 
If this is zero, go to step 15. If it is not zero* read 
from dIock SuPK2/256 into core location lIBuS +SUP. Add the 
number of woras read to SUP and to SUPK2. 

14. If SUPTG = 0* determine if we can insert the new entry. To 
dp this we first determine where the even entry boundary 
occurs in the core buffer since we may have read only part 
of an entry (12 does not divide 25b evenly). If the last 
entry in the buffer is greater than the entry we are 
inserting* the entry goes on this track. If this is not 
the case* go bacK to steo 13. Otherwise, set SUPTG to 1* 
make a 12-wora hole* insert the new entry* set SUP » SUP ♦ 
12* end go back to step 13. 

lb. riCAlfi-SfiClAQO* bet SUPS » 0. This is the number of words 
wr i t ten . 

lb. Compute number of woras we can write on tracK SUPLl. First 
set A s - number of words left to write on the track. If 
SUPLl a SUPKl* we haven't finishing reading everything from 
track SUPLl* so if SUPL2 - A > SUPK2 change A to SUPL2- 
SUPK2* which is the number of words we can write without 
destroying any unread directory information. If 
SUH-SUPS<-A* we aon«t have as much in core as we are 
capable of writing so set A = - (((SUP-SUP) divide 
2S6 ) x 256)* an exact number of blocks. 

17. If A = 0* we can»t write anything* so if SUPS=0 slide the 
remain SUP-SUPS woras in core up to location LIBUS* set 
SUPS = ang SUP = SUP-SUPS. Then go bacK to step 12. 

If A#G* write -A words to block SUPL2 divide 25b of track 
SUPLl. If SUPL2 ss 0, set the first 4 words of the SUPLl 
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PlftfcC entry to the first <* words written. Set SUPL2 to 
SUPL^-a* SUPS to SUPS-a* and go back to step 16. 

lb. set the new directory lengths into DlkbC and go back to the 
ca » I ing program. 
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iaeE-woot-CLEau-ue 

This overlay prints errors embedded in the Program after the user 

has entered a program under taoe mode of after a LOAD. rhe 
embedded errors are 3 word psuedo statements; statement number • 
length (=3) and error number. 

This routine is calleo in place of any command typed if the tape 
error flag in the user«s flag word is set. it is also called 
directly* if the error statement count (ER&CT) is non-zero* at 
the end of LOAD. 

The operation of this routine is as follows: 

1. Read in the user program from the disc. 

2. If on entry the error statement count (EttRCT) is zero then 
go to 13. This is the case if the user aborted the print- 
out of the errors. 

3. Strip out embedded error statements oy scanning the program 
for error statements and moving each one found to the end of 
the program as two word entries (the length words are 
deleted). Decrement the error statement count by one 

for each one moved. ^#,too the scan when the count reaches 
zero. 

4. put into ?T£mP a pointer to the first two-word error entry 
to pr int . 

5. write out to disc the Program, and errors to update the disc 
cooy of tne user's s*ao area. 

b. uet the statement number of the error. 

7. Read in the appropriate error message b I ock into the swap 
area starting at LIBUS. 

«. Move the desirea error message to LlflUS and append "IN LINE" 
ana the line number * 

9. print the error message. The reader should note that in 
the print routine (LOUT) the user has output wait status for 
a brief perioa of time. This allows the user to break this, 
an otherwise unbreakable routine. 

10. If the print fails (reject return from LOUT) » read in the 
program* get the pointer to the error to print from ?TEMP 
ana go to 6* 

11. Read in the program again. 
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12. Bump the pointer (in ?TEMP) to the next error entry to 
print. If there are no more error entries then go to 13. 
Otherwise go to 7. 

13, Set main; set the user's status to syntax; reset PBPTR to 
the end of the program; ciear the tape error flag and exit 
to RERRS+33.» 

*RERRS+33 prints the message LAST INPUT IGNORED* RETYPE IT and 
sets the user's status to idle* 



IlttE 

The TIME command prints the user's ID« port numoer • time useo 
during the session, the total time used to date and the total 
time permitted. The TIME command is callable from a Program 
from a program via the SYSTEM statement. 

The operation of TIMt is as follows: 

1. Get user's ID ano port number and compute time used in the 
current session from the TTY table. Put these values into 
output buffer. 

2. Read in the IDT to get total time useo (excluding the 
current ses.sion) and the total time permitted. 

3. compute the total time used and put it into the output 
buffer along with the total time permitted. 

4. print it on the terminal or exit to SYSCU with the Output 
buffer if it was a programmatic call. 



aUUOUwCt 

The ANNOUNCE is usea by the system operator to send a message to 
a port or al I the Ports. 

The operation of the command is as follows: 

1. Determine if the message is to go to one port or all ports. 
Fail if the ♦•ALL" was not typed or the port number is 

<0 or >31. 

2. Save the number of ports and the first port to output the 
message to. 



6-42 



3. Put a CR* LF* LF into FIL6F. Appena the message and 
another CR» LF* LF. 

4. Block the clock. 

5. Get the status of the report to output* If user is to 
run a type III program and execution had not yet begun 
(?RSTR=LIBRA) then we must abort the program because 
the buffer which now contains the parameter list for the 
program will be used to hold the message* First clear 
the port's status « deaueue the port and clear the ports 
OUT=P bit If set and then send "STOP" to the terminal to 
abort the executing of the command. 

6. If announce was to one port go to 7. otherwise loop In 
step 5 until all ports are checked. 

7. Send the message to the port(s). 

8. unblock the clock. 

9. Check the status of the port(s) that had the message output 
to it. If a port's status is inout wait then send an input 
wait command (iwT) to the IOP for that port. 



ASSIGN Command 

The ASSIGN command allows the system operator to assign a non- 
shareable device for exclusive access to all users* one user f no 
users* or to the RJt facility, word 3 of the device's device 
table entry contains this information: -A* no user; 0* all users 
(default)? 1, RJE only ? <idcode>» only that idcode. 

1. extract specific device designator. 

2. Search device table for corresponding entry. 

3. Determine whether assignment is to all* one user, none* or 
RJE. 

4. Set word 3 of device table entry. 

5. If assignment was to none* find if a user is currently in 
control. If so, set user's PACT bit and set status to 
abort (%A6RT). this will force the user off the device. 
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&U&&E Command 

The AWAKE command is responsible for waning up a suspended user 
when the user has suspended for either an ATTENTION NEEDED 
(device error condition 3) or because of a programmatic execution 
of the PAUSE command. 

1 # Determine whether command is AWAKE-<port numoer> or AWAkE- 

<speclflc device designator:*-. if the latter* continue at 4. 

?• Extract and validate port number; use port number to 
construct a pointer to user's part of TTY tabie. 

3. If user is suspended (status = %PAUS) ana it's because of a 
PAUSE command (sign of ?RTIM set) then set his PACT bit 
which will automatically wake him up. Exit routine. 

4. Extract specific device designator and find device in device 
table. If the device is busy* the user is suspended with 
?PAUS status* and if this device was the one that caused 
suspension, then we can awake him. 

5. If device is not the mag tape we change his status to 
output wait <?OUTw) and send start timea retries (STR) to 
the IOP. The loP will retry the device until it is ready at 
which Point it will wake up the user. 

6. If the device is the mag tape all we need to do is to set 
his PACT bit, when he is re-scheduled* ne will 
automatically retry the operation. 



BaNUEB command 

The BANNER. command accepts a message entered by tne system 
operator saves It on the disc in the last half of block on the 
system disc. The format of the message is a word with a byte 
count followed by that many bytes of the message. If the message 
is null* the count word will be zero. This message* if any* is 
displayed to users when they log on (see HELLO command). 

1. Read in block of disc 0. 

?.. initialize pointers to use byte filling routines. 

3. Extract message from console. if non-null, terminate it 
with CR/LF. 
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Set the count word to the number of bytes in the message* 
write out dIock 0, and terminate. 



BESIQW Command 

The BESTOW command transfers ownership of library entries from 
one account to another, optionally, we allow either ail entries 
or a single entry. All entries may be transferred only when no 
users are logged on the system, only Protected or unrestricted 
entries which do not duplicate names in the target account ore 
betstowed. The method is to scan for an entry In the directory* 
move it to the LTEMPS with a new account (adjusting MWA» PFA» and 
FCP bits if necessary), aelete the old entry, and Insert it where 
it now belongs. A running count of soace deleted from source 
account and space adaed to target account is Kept to update the 
IDT when the command completes. 

1. Extract oldid* newid* and optional single entry. 

2. Demand no users loqed on if entire library to be bestowed. 

3. Extract newid»s capabilities* account space used* and 
account space allowed and save them away. 

4. Find entry and determine feasibility of moving it. 

5. Save and delete old entry. 

6. insert entry for newid. 

7. Loop back to step 4 until no more entries left in oldid. 

fl. update oloid and newid IDT entries for space used. 

9. output any notifications of things not done becuase of 
protection, no space* duplicate names* or no entries 
bestowed. Note that only one of these messages is output 
if more than one condition Is met. 



SBE&tS Command 

The BREAK command overrides a user's disabled BREAK capability. 
There sre two bits of interest in the flag (?FLAG) word of the 
user's TTY table: PbFLG and CBFLG. PBFLG is set when a user 
programmat ical »y disables BREAK. The receive driver enables 
a BREAK attempt if PbFLG <> I or CBFLG <> 0. Thus* this command 
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can set CbFLG which will allow BREAK regardless of the state of 
PBFLG. 

1. Extract port number* validate it* and ensure user is 
logged on. 

2. Set CBFLG (which will override PBFLG* if set)* clear 
AbTRY (so previous tfREAK attempts will not cause trouble) 
ana ex 1 1 . 



CU&UGE1U 

The chaNGEIO command allows the system operator to modify the 
parameters In an ID entry. The Password* time allowed* disc 
space allowed and capabilities may be modified. The modification 
of the MWA* PFA and FCP may require ID'S directory entries to 
also be modified, 

1, Get the ID track the specified ID shoulo be on. If no other 
parameters specified print ILLEGAL FORMAT and exit, 

2, Search the ID tracK for the entry. If not found print 
NO SUCH NO ID ana exit, 

3, If a new passwora was specified then clear the password area 
in the ID entry and Put the new one in its Place, 

4, Modify the disc and time limit If specified. 

5, Save the initial states of mwa* PFA* and FCP, 

6, Modify the ID'S capability if any were specified, 

7, write out the updated ID entry out to disc. 

8, If tne ID had mwa but now doesn't or if the user's PFA or 
FCb capability had changed* the ID'S airectory entries 
must be modifiea* otherwise go to step 10, 

9, Read in the ID'S directory entries and modify the mwa* PFA 
ana FCB bits in the status word appropriately, 

10, Terminate, 
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The COPY command allows the system operator to copy a 
program/file from one id to another. 

The operation of this command Is as follows. 

1. Get and save oldid and oldname. Put the 10 and name Into 
LTEMP 0:3 and also into a temporary buffer. 

2. search the directory for the oldname. If It does not exist 
print NO SUCH ENTRY and exit. 

3. Move the old remaining part of the old directory entry. The 
new directory template. 

4. If the entry is larger than 200 blocks and there er@ users 
logged on then print USERS LOGGED ON and exit. If the 
entry is LOCKED op PRIVATE then print PROPRIETARY ITEM NOT 
COPIES and exit. 

5. If the entry is a file and the file has neither the read 
nor write capability then print PRIOPIETARY ITEM NOT 
COPIED. The file was in the oocess of being created. 

6. Get the new ID anp new name and out into LTEMP 0-3. 

7. Copy the Protection bits from the old directory entry to the 
name words of the directory template. 

8. in the status word of the directory entry template clear the 
MwA bit if set i ¥■ the new id does not have this capability. 
Set or clear the pfa and FCP bits according to the new ids 
caoabi i Sties, 

9. Check if there is enough room in the new id's account for the 
new entry. If not print LIBRARY SPACE FULL and exit. 

10. If the entry to be copied is non-shareaole device go to 
step 12. 

11. Search the ADTs for space for the new entry. Print SYSTEM 
OVERLOAD and exit if space could not be found for it. Save 
pointer to ADT entry and put the disc address into the new 
directory entry template. 

12. Search the directory tracks for a duplicate entry. If there 
is one print DUPLICATE ENTRY and exit. 

13. Copy if necessary the entry into the space found in ^0 
block chunks. Read the chunk first into the user area then 
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write to the new space. 

14. Determine where in the directory the new directory entry 
should go. Cai I SUPERSAVE If necessary. SUPERSAVE will 
perform the next step and go to 16. . 

15. Set the last reference and last change date In the template* 
insert the entry into the directory* uPoate the DIREC and 
write the directory track back to disc. 

16. If new space was not allocated (entry copied was a non- 
shareable device) then go to lb. 

17. UPdate the space used in the new id«s IDT entry and update 
the ADT. 

18. Update the system tables on disc and terminate. 



dlSEBfcialfc 

The HIBERNATE command is Identical to the SLEEP command except 
for the following additions/changes: 

0. Set the current time into HDATE. 

9. Set A = -1 (hibernate) and jump to the aump. (20000b of the 
loaoer ) . 



QEyiCE System Console 

The DEVICE command lists information of all devices on the 

system. The device designator* select code (in octal)* the 

record size assignment (ail* a specific ID* ••RJE" or ••NONE")* and 

user (an ID and port or M RjE M or blank) are printed for each 
device. 

The routine operates as follows: 

1. print first two lines of headina. 

2. Get the number of device tables entries. If none then 
terminate. 
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3. Save pointer to the head of the device table. 

4. Decode and put into the output buffer (T35bT) the device 
designator* the aevlce select code the maximum record 
size* the assignment and the user (if the device is 
busy) • 

5. Print. 

6. Bump the device table Pointer. If there are no entries left 
then terminate? otherwise go to 4. 



QlSECIQtiX System console 

The DIRECTORY command list on the system console* by ID? 
directory Information. This information includes the. ID? printed 
only with the first entry of an account? the entry name? 
the last reference aate? the length? the oevi ce/address and the 
record length. The user may optionally specify a starting ID. 

The operation of the command is as follows: 

1. Determine if a starting ID had been specified. If so? save 
it in ID otherwise save 1 in ID. 

2. Decrement the ID by one and save in T35fiF+3b. 

3. Print the first heading line and suspend. 

4. Move the second heading line into T3S6F and print and 
suspend. 

5. Retrieve the ID save in T35BF+35 Put into LTEMP. Set 
LT6.MPUS3) TO 177777B. This will cause tne list to start 
at the ID specified or the first one beyond if the ID does 
not ex i st . 

6. Search the directory to find the first entry beyond the one 
sought. Save the ID of this entry in T35dF+3S. 

7. If the ID is -1 (psuedo entry) then terminate. 

8. If the ID code was different from the Previous (sought) ID 
then include the ID in the line we are building. 

9. continue building the line by adding the entry name? the 
last reference aate? the length? the device/address ana 
the record length. 
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10. Print ana suspeno, 

11. Retrieve the ID code from T35BF+35 and the name of the entry 
from right byte of T35BF+4 to left byte of T35+7. 

12. Put this into LTfcMP(0:3). This is the new entry sought. 

13* Goto 6, 

QUME Command (System operator) 

The DUMP command entered by the system operator either enables 
the use of AOOO's DUMP command or disaoles it. The routine sets 
the words DUMP1 and DUMP2 (which reside currently in the library 
subroutines area) to the time it will be when the DUMP capability 
will expire. The A000 DUMP command demands that the current time 
be less than this value. 



1. Extract* convert to binary* and validate tnat 
specified is between and 60. 



t ime 



2. Add this time to the current 
DUMP2. Exit the routine. 



time of day and save in 



DISCONNECT. Command 

The DISCONNECT commana logs off the specified users from the 
system. It is done by merely changing the user status to 
disconnect (StDISCM this effectively simulates the situation 
when a user has physically disconnected from the system. 

1. Determine whether command is DISCONNECT-ALL or DISCONNECT- 
(port number). Set LTEMP+1 to minus number of ports to be 
disconnected and LTEMP+3 to Point to the first port's TTY 
tab le. 



2. 



Looping on the counter (LTEMP+1)* set each user's status 
to disconnect ana set the user's PACT bit to force the 
scheduler to notice the disconnect. 
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tSlLLIQ 

The KILL1D command is used to remove ID codes from the system* 
KILLID first deletes the 10 from the ID track. Then the 
directory is scanned backwards to delete entries belonging to the 
ID, A patch table is constructed at LIBUS + 8192 to aid the 
return of space to the ADT. The patch table holds three word 
entries: a two word disc address and the length. The routine 
RTADT which resides on disc is called to Interogate the Patch 
table and return the space to the ADT, 

The operation of KILLID is as follows* 

1. If users are logged on the system then print USERS LOGGED 
on and exit. 

2. If the ID specified is A000 then print A000 NOT ALLOWED and 
exi t . 

3. Search the IDT for the ID. If not founa Print No SUCH ID 
and ex i t . 

4. Delete the IDT entry from the ID track and update the IDT 
and its IDEC entry. 

5. scan the directory backwards for an entry which belongs to 
the ID to be ki I led. 

6. Put an entry in the Patch table for the program or file. 

7. If the Patch table cannot hold-another entry then go to 
9. 

8. Get the next entry on the directory track. If the next 
eirectory entry belongs to the ID to be killed then go to 6. 
If the next entry does not then go to lo, 

9. Collapse the directory tracK* write it out* update the DIREC 
and return the space in the Patch table to the ADT. 

10. Go to the next directory track and go to 5. 

11. collapse the directory track* write it out* update the 
DIREC and return the space in the Patch taple to the ADT. 

12. UPdate the disc copy of the DIREC* IDEC and EQT and 
term inate. 
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&LOCK Command 

The MLOCK command allows the system operator to remove disc 
blocks from general usage either because they are bad or because 
the I nstal lat Ion wishes to preserve some olocks for other 
purposes (one use could be a disc with both Access and RTE or DOS 
resident)* MLOCK is one of those few commands where any 
additional documentation would be redundant. See listing for 
any additional details. Also see data structures for the format 
of the Socked olocks table. 



MUULOC& Command 

The MUNLOCK command frees disc blocks locked by the MLOCK 
command. See listing for additional details. 



UEttiQ 

The NEWID routine aoas an entry to the IDT. The new IDT entry is 
built in NEWBF before inserting into the IDT. 

1. Scan the parameter list for the ID and read in the ID track 
it should go on. 

2. Get the password and Put it into the ID entry template. 

3. Get the disc space allowed and time allowed and Put into 
template. If a Ck follows then go to step b. 

4. Scan the parameter list for capabilities and device designa- 
tors. Call the attribute search routine (SAT) to get the bit 
position for each parameter. Set these bits in the capabil- 
ity word of tne template. 

5. Put the new ID into the template. 

6. If the ID tracK is full then call SUPERNtW to redistribute 
the ID tracks, bo to step 7. 

7. Search the ID track for a duplicate entry. If not found 
then Insert the entry* update the IDEC entry for the track 
anp write the track Deck to disc. 

8. Terminate. 
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sueEBbtw 

This is a routine in the NEWID overlay that is used to evenly 
redistribute the IDs on the ID tracKs. SUPERNEw operates 
very similarly t.o SUPERSAVE except that it does not build a 
table to save the new length of each track or insert the new id 
entry into the IDT. 

The routine first calculates the size each track should be when 
redistributed If the new ID entry had already been inserted* A 
fail exit is taken If there is no room for the new entry. Next 
the IDs are packed into the last most ID tracks. Then the tracks* 
starting with the first one is filled to the required length. 
The track the new entry is to go on is f i I I eo with one less entry 
and the first word of the track's IDEC is set to the new ID* 
this is so the FIDT routine will find this tracx* to insert the 
new ID* when SUPERNEw returns to step 7 of NEWID. 



BtiQWES Command 

The PHONES command informs the TOP of the number of seconds that 
a user is allowed to have for log on attempts before we hang up 
the phone. The IOP starts this timing when a port Initially 
brings up data set ready* The time is initially set to 120 
seconos at IOP generation. It can be set to to effectively 
prohibit access to the system (the IOP ooes this by setting a 
nominal time of .2 seconds which is too short to allow anyone to 
loa on), 

!• Extract, convert to binary* and validate the time value. 

2. Send this value to the IOP and exit the routine. 



BUBGE Command (System operator) 

The PURGE command deletes any programs* files* or non-shareable 
device designators that have not been referenced on or after the 
date specified. The method is to scan the directory for 
qualified entries* deleting them as they are found. As the 
entries are found*, we build a table of them immediately beyond 
the directory track in memory. Whenever the table fills* we 
temporarily suspend processing the directory to call in an 
overlay which returns the soace occupied by purged entries to the 
IDT and the ADT. 
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1. interpret and validate the date aiven. 

2. Reject command if any files are in use by scanning the TTY 
tables for any 0UT= files and for any FUSS table entries. 

3. update, the last reference date of the HELLO Pirogam (if any) 
so it does not disappear. 

4. Scan all directory tracks on system* deleting entries when 
they Qualify. Add entry to Patch table. 

5. when patch table is full* remove space from XOT and ADT. 

6. when last directory track "has been scanned* remove space 
from IDT and ADT if any entries in patch taole (see user's 
PUkGE command for a description of RT1DT and RTADT). RTIDT/ 
RTaDT will exit back to the System if last call. 



tfteotl System console 

The REPONT command Prints IDT information on the system console. 
For each IDT entry* the user ID* the time usea* the disc space 
used* its capabilities* and its device designators. Note that 
the time used does not include time consumed of active users. 

1. If an ID was specified get It and save it in REPLN. If 
not save I in kkPLN. 

2. Print the first head i nq line and suspena. 

3. Retrieve the ID in REPLN ana find the ID or the first Id 
passed it. If the ID is beyond the last one on the system 
then print the second line of the heading and terminate. 
Otherwise set REPlN = -number of words from the ID entry to 
the end of the track and set PEPPT to point to the -length 
of the ID track in tne IDEC table. 

4. Print the second line of the heading and suspend. 

5. Determine from kEP|_N ana REPPT the dock on the disc the ID 
entry res ides . 

6. Reaa in the ID entry ana set REPID to point to it in memory, 

7. Build the report line in TJbtfF. 

8. Hump REPLN by 12. If the result is zero (the entry just 
processed was the last one on the ID tracn) go to 9. 
Otherwise print the line* suspend and go to b. 



6-54 



9, If there are no more ID tracks then print the line and 
terminate. 

10. Reset RfcPPT to point to the ID track •s-l ength and RePLN 
to the -length of the new track. Print the line* suspend 
ana go to 5* 
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SESEI' 

The RESET command modifies the time used to a date of a user's 
IDT entry. it operates as follows: 

1. Set ID = REST b 0. 

2. If the idcode s "ALL" go to 3* otherwise set 10 equal to the 
specified ID code and read the proper IDT track. 

3. If no time specified* go to *. otherwise set REST equal to 
specified time. 

4. If ID = 0* go to 5. otherwise search for the specified 
idcode. Fail if not found. If found* set its time entry 
to REST* write the IDT track back and terminate. 

5. Set the time entry for all the i dcodes on this track to 
REST and write it back to olsc. 

6. Move to the next IDT track. If all are finished* terminate. 
Otherwise reao the IDT track and go to b. 



RQSIEB 

The ROSTER routine Prints a listing of the idcodes of all active 
users. These are obtained from the ?ID word in the 3d TTY 
TAbLES. The absence of a user is indicated by the word being 
zero. 



tfJE Commana 

The RjE command extracts an RJE message from the console buffer 
and notifies the loR that a message is Pending. At some later 
point in time* the IOP is supposed to send the system a wake RJE 
up (WRU) command. This sets a f I aq which the scheduler interro- 
gates and* if a message is pending* will sena tne message to the 
IOP. The RJE interconnect k i t command serves two purposes, 
within this command it only notifies the IOP that a message is 
pending; we do not bother to check for acceptance since we know 
that It is always rejected the first time (this is incredibly bad 
programming and snoulo be changed at the first opportunity). In 
the scheduler we actually check for acceptance and* If accepted* 
send the Rjfc message. 
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1. reject commana if previous message is still pending. 

2. Extract message and Place Into RJE command buffer (currently 
resident following the library overlay area). 

3. Save message length in first word of buffer. 

4. Nofity IOP that Rje command is pending, we do not need to 
pick up the reply code since it will sit on the Inter- 
connect Kit without harm. The STC* C done by the IOP serves 
as our acknowledgement that the command was accepted. 



SLEEP. 

The SLEEP command is used for system shutdown. It operates as 
f ol lows : 

1. Remove all users from the queue and make sure they can't 
get back byj 

a. Clearing each user's ?FLAG word except for the OFCHK 
bit 9 in his TTY table. 

b. Setting all status words to -2 (*01SC>. 

c. Sending a KTo to all active terminals (?I0 =0). 

d. Setting T35LK to point to MLINK+1. 

2. Kill all ousy devices and clear the fifth word of each 
device table entry. 

3. output the sleep message to all active users* preceeded and 
fol lowed by a CKLF. 

a. Tell the I/O processor were going aown by sending a SSO. 

5. Call LCD to update the last change date for files for each 
port that has its DFCHK bit still set. Clear the OFCHK bits 
when done with each port. 

6. update the IUT entry for each active user and create a 
logoff entry in LoGGR. 

7. wait for the console to finish outPutting. 

8. wead in the loader, turn off all the X/O and the interrupt 
system* set power fail to halt. 

9. Set a = (sleep) and jump to the dump (^OOOQfl in the 
I oaaer ) . 
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SlalUS-r-bXSIEb-CQBSOLE 

The STATUS routine Prints a summary of the various system 
resources and the extent of their utilization on the system 
console. It operates as follows: 

1. Print the heaaing consisting of system io« date and time and 
suspend. 

2. Print the logical unit* select code* unit number* first 
block and last block of the discs on the system. 

3. Print a list of those disc blocks which have been mLOCkED. 

4. Print the disc aadresses ana lenaths of the IDT« ADT ana 
Directory tracks. 

5. Print the disc aadresses and lenqtns of the system segments. 

6. Print the user swao track disc addresses. 

7. Terminate. 
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OVERVIEW 



I. Introduction 

I/O processor software in the HP2000 ACCESS system provides 
two concurrent and ostensibly independent functicns: The 
simultaneous support of up tc 32 time share users and a Heoote Job 
Entry (HJE) facility for access to batch systems in IBB 360 and 
370 computers. This access is gained through a line printer and 
card reader attached to the I/O Processor (IOP) of the HP2000 
ACCESS system. The TSB user also has access to the remote batch 
system via a remote file transfer capability. 

The RJE function utilizes the IBM multileaving communications 
protocol. This protocol was originally only available with IBM 
operating systems including HASP but is now also supported by 
IBM«s ASP, VS1-JES, VS2-JES2, and VS2-JES3. The protocol provides 
for concurrent operation of multiple data streams, both 
transmitted and received, and includes data streams specifically 
used for remote operator control. This multiple stream capability 
will be specifically exploited in future system enhancements. 

The time-share function includes more comprehensive error 
detection, automatic speed detect, and terminal user access to 
non-shareable devices attached to the IOP (e.g. card readers and 
line printers) • 
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II. Design Overview 
J2§§i2I a ssump t ion s 

Certain elements of hardware required by this project are new 
to a 2000 series tiae share systea. Hicroprograaaing is used to 
improve performance through special purpose instructions* The BJE 
comauhications I/C support is based on a 12613 synchronous 
transmit/receive interface. h variety of card readers, line 
printers and paper tape punches aay be used as peripherals 
available to both the TSB and BJE user* 

0££iational assua ptj.ons 

The RJE function typically requires specific attention on the 
part of an operator. He is required to activate and deactivate 
the function as well as tc control its activities (operator 
control and coaaandsi reader and printer operations, and 
communications line management) . Although it is not required that 
the operator be knowledgeable of host systea (IBH 360 or 370) job 
processing, he should be faailiar with reaote operational 
procedures. This knowledge can cnly be acquired in cooperation 
with IBH and personnel at the host site. 

It is expected that this software will be used in an 

environment having a requireient for both time sharing and remote 

batch processing but having no need for interaction between the 

two. Remote file transfer capability provides the TSB user access 
to the RJE function. 

Performance of the system is designed around the assumption 
that the TSB user and his response times are more important than 
the RJE function. For this reason, the RJE function will 
generally receive lower priority than TSB and aay show degraded 
performance when TSB activity is heavy. 

Design saaroaxi 

The structure of the I/O Processor software is an 
interrelated collection of acdules each perforaing a predefined 
task. Two groups cf modules exist. One group consists of the IOC 
(I/O Control) aodule and all I/O drivers. Based on the Hewlett- 
Packard Basic Control Systea (BCS) , this group of modules 
encompasses all I/O service, scheduling, and control. The second 
group of modules makes up the actual data processing system. 
These modules arc divided into three general classes: supervisor, 
manager, and function handler. The supervisor section provides 
run time control of which modules are executed; the manager 
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section provides services utilizable by any other nodule in the 
system; and function handlers control devices and/or major 
processes in the system* 

The supervisory task is carried out by the Dispatcher , which 
controls the execution of function handlers on a priority basis. 
Function handlers are dispatched when an I/O operation, initiated 
by them, completes; or when explicitly scheduled through the Queue 
Manager* This explicit scheduling of a handler is called 
"priming," All such execution control is performed by the 
Dispatcher and control is always returned to the Dispatcher when a 
handler completes its processing* 

Managers provide communication and support services for the 
handlers* Interhandler comsunication is provided through the 
Queue Manager (QM) • The QM is the central message switching 
routine in the system; maintaining work queues, buffer routing, 
and priming cf handlers when work is queued* The Buffer Manager 
(BM) controls all buffer acquisition and release, and administers 
all buffer pools in the system* The Allocate/Deallocate Manager 
(ADM) ^Gntrols the use of non-shareable resources by the IOP* 
Through its services a not-shareable resource, such as the line 
printer, may be assigned to a -particular task, such as RJE* In 
addition to these managers, several general purpose data handling 
routines and common subroutines are included* 

Function handlers control devices or major processes in the 
system* Associated with each handler is a quaue or queues* These 
queues are the source of work for the device or process which the 
handler controls. Handlers typically initiate I/O operations to 
devices (through the use of queued IOC) and perform necessary 
processing when the operation completes* other handlers never 
perform I/O* Instead they perform major processing functions and 
are driven strictly by Dispatcher priming* Through the services 
of the QM, handlers inform cne another of work to be performed by 
making entries on work queues* The handlers also acquire and 
release buffers and the use of non-shareable resources where 
appropriate. The term "handler" or "function handler" should not 
be confused with "driver" at the 0CS IOC level* The function 
handlers in current use are: 



Interconnect Kit Handler 

Multiplexor Handler 

ASCII File Handler 

Time Base Generator Handler 

Line Printer Handler 

Card Reader Handler 

Synchronous Communications Handler 
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8. Console I/O Handler 

9. Host Inquire Compression Handler 
10* Host Message Decoiprejsion Handler 

11. Host Reader Compression Handler 

12. Host List Decompression Handler 

13. Paper Tape Punch Handler 

14. Photo-reader Handler 

15. Reader/Punch/Interpreter Handler 



Time- £ha;ce F unction 

The time-share functicn cf the I/O processor is graphically 
illustrated in figure 1. Tvc distinct types of data flov are 
implicit in this function: the terminal user/system dialogue and 
communications with ASCII file devices. Several handlers 
participate, some on a shared basis, in these communications; 
specifically, the interconnect kit, the ASCII file, the 
multiplexor, the card reader, the paper tape punch, the photo- 
reader, the reader/punch/interpreter, and line printer handlers* 

H*lQZ "Qdule Eelfl t jonshA P? 

The user/system dialogue is conducted exclusively through the 
interconnect kit, serving as an interface with the system 
processor, and the multiplexor, functioning as the terminal/user 
interface* Although each hardier is served by a single gueue, the 
connection does provide the capability for 32 concurrent and 
independent data streams (one for each terminal user) • Neither 
handler is allocatable by the Allocate/Deallocate Manager since 
they are permanently associated with each other* Operations on 
any data stream are controlled by the interconnect kit handler at 
the dictate of the system processor* This control is exercised by 
the dispensation of buffers by the interconnect kit for reading, 
writing, and control operations* The only exception to this 
structure is the ability of the multiplexor handler to request 
special processing for unusual conditions, i.e., line break or 
break character received* 

ASCII file communications are carried on between the system 
processor via the ASCII file handler, and an external I/O device 
via the handler dedicated to its operation* The ASCII file 
handler is served by a single wcrk gueue supporting multiple data 
streams as in the case of the interconnect kit handler* Such is 
not the case, however, for the external device handlers which are 
single gueue, single data stream processes* The information 
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necessary for data stream identification is solely a function of 
the ASCII file handler and need not concern the external handlers. 
The connections between handlers performing ASCII file operations 
are not permanent, since tie devices themselves, the card reader 
and line printer, are also required by the HJE function. While 
the connections are established, however, control is vested in the 
ASCII file handler as it is in the interconnect kit for terminal 
traffic. That is, control is exercised by dispensing buffers for 
reading, writing, and control operations. 

Data flow 

The following message flow is possible among handlers for tha 
time-share function: 

Interco nnec t K^t - transmits buffers to the multiplexor for read, 
~~ write, and control operations. Receives buffers from the 

multiplexor for write and control operations and empty 

buffers for discretionary use. 

Multiple xor - transmits empty buffers to the interconnect kit for 
its discretionary use aid also sends buffers for write or 
control operations, Receives buffers from the interconnect 
kit to be used as directed; read, write, or control. 

ASCII file s - transmits buffers to the card reader and line 
printer to be used as directed; read, write, cr ccntrol. 
Receives buffers from these handlers for transmittal to the 
SP (write or control) oz for discretionary use. 

Card reader - transmits card images to the ASCII file handler and 
" " receives buffers from the ASCII file handler to be used as 
directed (read or contrcl). 

Line printer - transmits empty buffers to the ASCII file handler 
for its discretionary use and receives buffers from the ASCII 
file handler to be usad as directed (write cr contrcl). 
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RJE Functio n 

Figure 2 illustrates the RJE function components. Scaa of 
these components represent ncn-shareable, allocatable resources 
for which the RJE function competes along with TSB users* Some 
software modules depicted in figure 2, therefore, are the same 
ones shown in figure 1. Three general levels of software exist. 
Central to the design is the synchronous communications handler. 
Here are isolated (as much as possible) details of line protocol 
and control. All line I/O occurs at this level. This aodule is 
also adaptable to the configuration of the remaining tuo levels. 
At system initialization time, it determines that configuration 
and subsequently deals with it. Thus, for example, the number of 
input data streams need net be known to this level in advance* 

At the second level are all modules which interface directly 
with the level one communications module. Some are input related 
modules which acquire and f re process data to be transmitted* In 
the case of multileaving, preprocessing involves blocking and 
compression of data. Other modules are output related. They 
accept blocks of data from the synchronous communications module 
and prepare it for output* Hith multileaving ttis means 
deblocking and decompressing. At system initialization time, the 
synchronous communications handler at level one determines how 
many input and output modules exist at level two. At run time it 
then provides instructions to these modules about current running 
conditions. 

Level three modules are concerned with actual I/O operations. 
These modules may represent allocatable resources (e.g., a line 
printer) which a level two module must acquire* These 
acquisitions are typically initiated by operator commands or other 
signals from the communications line. Once the acquisition is 
complete, the associated lavel two module either provides data to 
or accepts data from the level three module* These sc-called 
level three modules are not tinigue to the RJE function. They are 
in fact the same modules which will be used by the ASCII files 
handler. In the case of remote file transfer, the level three 
module role is played by the. ASCII files handler. 

Console communications require special attention. The 
console (ASR-35) is attached to the system processor, not to the 
I/O processor. For this reason, minor changes to the system 
processor have been designed to allow transfer of messages to and 
from the I/O processor. These messages either originate from' or 
arrive at a level three module concerned with console I/O. Due to 
the often unique nature of console messages, required interaction 
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between this module and any ether module in the systen is made 
possible. 

Ml2£ Hodule R elationsh ips 

Seven level three modules will be used. The line printer 
handler will be the same module used by the ASCII file handler. 
It does represent an allocatable resource and will therefore have 
no permanent connection to the level two module (host list 
decompression) with which it communicates during the RJE function. 
A card reader handler will also exist. It represents a 
potentially allocatable resource. Like the printer handler, it 
will have no p ermanent connection to the level two module (host 
reader compression) with which it communicates. The card reader 
handler is being designed for general purpose future use and will 
be able to read data in several modes. The third level three 
module is a console I/O module. This module is not allocatable 
since it represents a resource shared by everyone. Any module may 
present output messages to it for display on the console. Also, 
it will route messages received from the console to the intended 
recipient of the message. The fourth level 3 module is a paper 
tape punch handler. It alsc represents a potentially allocatable 
resource and will have no permanent connection to the level two 
module (host punch decompression handler). The fifth level three 
module is the photo-reader handler. It represents an allocatable 
device and will have no permanent connection to the host reader 
compression handler. The sixth level three module is the 
reader/punch/interpreter handler. It also represents a 
potentially allocatable resocrce and may be temporarily connected 
to the host reader compression handler or the host list or punch 
decompression handlers. The seventh level three nodule is the 
ASCII files handler. While it normally plays a level two role in 
behalf of a TSE program which is accessing some peripheral, it 
here plays a level three role. It may communicate with either the 
host list decompression, host punch decompression, or host reader 
compression handlers to perform the job list, job punch, or job 
transmit functions for the TSB user. 

Five level two modules will be a part of the design. One 
host list decompression module and one host punch decompression 
module . will exist. The module is directed by the synchronous 
handler to obtain a printer cr punch. Following such acquisition, 
data is accepted, deblocked, decompressed, and translated for 
delivery to the associated printer or punch handler. A similar 
function is performed by a single host message decompression 
module. One difference is that no allocation takes place as the 
console is always available. One host reader compression module 
also exists. It is activated by the synchronous handler and 
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operator commands in order tc allocate a reader for reading, 
compressing, and blocking of data. These data blocks are then 
delivered to the synchronous handler. A similar module performs 
preparation of console input nessages. Centralized compression 
and decompression subroutines reduce the redundancy of sections of 
these modules. 

Some special comments about the design of the hest list 
decompression and host reader compression modules at level two are 
needed. In anticipation cf future requirements for multiple 
streams, these level two modules vill be coded in a "serially 
reusable" manner. This means that all potentially volatile data 
associated with a particular data stream will be isolated frcm the 
code itself. In essence, the code may be viewed as a subroutine 
which operates en a data structure provided to it. Then the 
actual level two function handler consists only of the block of 
data for a stream, plus those instructions needed to invoke this 
"serially reusable" subroutine. To add a second or third card 
reader stream would require, enly the replication of this data 
structure component. Agaic, due to the unique nature cf console 
activity and requirements, level two console modules will not 
follow this design. 

The synchronous communications handler at level one is unique 
in that it is driven by nine distinct input work queues. Pifteen 
distinct output work queues are also supported. The number of 
queues actually used is determined at system initialization time. 
One console input stream ard up to seven card input streams make 
up eight of the input work queues. The ninth is a general purpose 
work queue used to receive operator control commands and other 
items such as buffers. The fifteen possible output work queues 
are a console output work queue, seven printer output wcrk queues 
and seven punched card output work queues. Obviously very few of 
these will be utilized initially. Communications line activity is 
initiated and deactivated by this handler as dictated by operator 
control commands. 

Data flow 

The following message flew is possible among handlers in the 
RJE function: 

C ons ole I/O - Sends reader control commands to the hest reader 
compression""module, communicatiens line control cemmands to the 
synchronous handler, and remote inquiry commands to the host 
inquire compression handler, and remote inquiry replies to the 
ASCII files handler for the job message function. Beceives 
console messages from virtually anyone. 
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ilSJis 3,ng\iye compressi on - Sends blocks of con pressed remote 
inquiries to the synchronous handler. Receives remote inquiries 
from console l/c and operational control signals from the 
synchronous handler* 

Hos^ nf ss aqe d eco mp ression - Sends aessages to console I/O and 
control information to the synchronous handler. Receives blocks 
of console messages from the synchronous handler* 

£&£& Reader. - Sends card images to host reader compression. 
Receives control signals froi card reader compression. 

Host leader, compression - Sends blocks of card images to the 
synchronous handler, reader activity messages to console I/O, and 
control signals to the level 3 handler (card reader handler or 
ASCII files handler) • Receives control signals from the 
synchronous handler, reader control commands from console I/O, and 
card images frca the level 3 handler. 

££JLl&££ ~ Sends control signals to host list decompression. 
Receives print images from host list decompression. 

H2§Js lj,§t ,(°.r;.B¥n, ch) decompression - Sends control signals to the 
synchronous handler, print or punch images to the level 3 handler 
(printer handler, paper tape punch handler, or ASCII files 
handler), and printer activity messages to console I/O. Receives 
control signals from the level 3 handler and synchronous handler, 
and blocks of cutput images from the synchronous handler. 

Synchronous handler - Sends lessages to console I/O in response to 
connection requests, blocks cf output data to all level two output 
modules (host message decompress and host list decompress), and 
control signals to all seccnd level modules. Receives input 
blocks from all level tvo input modules (host inquire compression 
and host reader compression), commands from console I/O, and 
control signals from output lodules. 

&SQII £kl£SL laallSS - Hhen Flaying its level three handler role, 
the ASCII files handler can be the source of data for the host 
inquire and host reader compression handlers* At the saae time, 
it can be the sink for the data provided by the host message and 
host list and host punch decompression handlers* In this 
capacity, the todule is the link between the TSB user and the RJE 
subsystem* 
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PuggUOfl feandlers 

All systea function handlers are described in the following 
sections. Naaes associated with these function handlers are as 
follows: 

Naae Level Handler 

Interconnect Kit Handler 

Multiplexor Handler 

ASCII Files Handler 

Tiae Ease Generator Handler 

Line Er inter Handler 

Card Feader Handler 

Synchronous Comaunications Handler 

Console I/O Handler 

Host Inquire Coapression Handler 

Host Eessage Decoapression Handler 

Host Eeader Coapression Handler 

Host List Decoapression Handler 

Host Eunch Decoapression Handler 

Paper Tape Punch Handler 

Photo-reader Handler 

Reader/Punch/Interpreter Handler 

Handlers are roughly classified into three levels. Level one 
handlers are typically in control of aajor processing areas* 
Level two handlers also are involved with aajor processing areas 
and are often very closely tied to a level one handler* C&n 
exaaple is the activity between HRO or HLO and SFH.) However, the 
Bain point which distinguishes a level two handler froa a level 
one handler, is that a level two handler will acquire and control 
a level three handler to per for a work on its behalf. In order 
that a given level three handler can be used by any level two 
handler (e.g. ASFH-CRH or HRC-CBH) , a definite aessage and control 
flow protocol is defined for using a level three aodule. This 
protocol is defined as follows: 

1. A level two aodule (L2) allocates a level three aodule 
(L3) using the ADE. L2 sends a "start" coaaand to L3. 
This coaaand is sent in a control buffer and is used to 
activate the connection. In this buffer are paraaeters 
needed by both L2 and L3 to aaintain the connection as 
well as to initiate it: 

word Bit(s) Function 
BCW 1 15-11 May be used by L2 to in for a L3 
7-4 about any desired operational 

aodes 
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14-0 


7 


15-0 


8 


15 
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1-0 



13-8 Informs L3 of data streaa 

identifier to be used in BCV2 
of all future aessage exchanges 
Queue naae of L2 to which future 
aessages are returned 
Length of required buffers 
in positive bytes 
1 * RJB aodule issued start 
■ ASFH issued start 
Hay be used as needed 
Indicates basic operational aodes 
Por input: 
00*read ASCII 
10* read EBCDIC 
For printer output: 
00* Space then print 
01*Print then space 
For paper tape punch output: 
00*punch node in Data word 1 
Olapunch node changed by control 
operation 
Data 1 15-0 Huaber of buffers needed 

for the connection 
(Zero is not a legal nuaber) 

Opon receipt of this aessage, L3 is expected to: 

a* Betain supplied inforaation. 
b« Perfoca any initial I/O operations (such as 
eaitting punched tape leader). 

c. Acquire the nuaber of buffers specified in 
data word 1, interlock thea, and return 
them to L2 with BCW3 containing the queue 
nana iound in the start coaaand, and BCR2 
containing a "nop** coaaand and data streaa 
identifier as noted above* 

d. Free the control buffer containing the 
"start" aessage. 

2. L3 accepts read cr vrite coaaands froa L2. These will 
appear in the buffers supplied to L2 by L3 as noted in 
(1) above. BCW word 7 is used by 12 to indicate the 
desired positive length in bytes (characters) of reads 
or writes. Upon coapletion of the operation, the 
following occurs: 

a. If a read, the coaaand is changed to write. 

b. If a write, the coaaand is changed to nop. 
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c. The buffer is returned to L2 with a •PUTQ 
if a write or with . PBIQ if a nop. 

If an operation completes in error, the following 
occurs: 

a* The original operation is held by L3 for 
later retry either after a timed pause or 
at operator direction. 

b. A control buffer is acquired by L3 and is 
set with an error command (6) , appropriate 
BCW word 8 general error indicators, and 
stream identification. This buffer is sent 
to L2. 

c. For all errors, a retry must be indicated 
by receipt of a type 9 conaand. This aay 
coae directly from an operator or aay be 
generated internally by L2. For a type 1 
or type 2 error (see BCW word 8 
description) , a timed retry is performed by 
L3. Only when a device makes a transition 
from ready to not ready should L3 report 
the error to L2. A continued not ready 
condition after timed retry is not 
reported. For type 3 errors, an immediate 
retry is performed upon receipt of the type 
9 com sand. 

3. L3 aay receive control commands from L2. These are 
defined by L3, and the buffers are discarded by 13. 

5. A "purge" command from L2 to L3 may appear in a buffer. 
The command will be in a non-interlocked buffer which 
should be released by L3. In response to the purge, L3 
should: 

a. Purge any pending operations and return the 
buffers to 12 as nop's. 

5. A "stop** command frcm L2 to L3 may appear in a buffer. 
The stop command Bust be in an interlocked buffer for 
eventual return to L2. L3 must do the following in 
' response to the stop: 

a. Complete any pending operations. 

b. Perform any final task (such as emitting a 
punch tape trailer). 
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'c. Returc the w stop M aessage to L2 after 
having returned all read or write buffers 
to L2« It is always the responsibility of 
L2 to release buffers. Bead and write 
buffers active at the tine of a stop are 
considered purged* It is not necessary to 
complete operations with thee, and they say 
be returned as naps. 
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I. Introduction 

&!§£££ aI2£i. 

Queued . IOC. is the input/output control subroutine within 
the I/O subsystem of the IOP program for the HP2000 ACCESS system. 
It provides for scheduling of I/O requests and notification of the 
completion of these requests. Queued .IOC. differs frci existing 
versions of .IOC. (non-buffered and buffered) in that it will 
maintain queues of I/O requests for individual devices and a 
priority queue of completed requests for all devices. Also, 
facilities are available to interrogate the queue of completed 
requests and to manipulate the scheduling of I/O. DMA use and 
conflicts for use are also managed and scheduled by Queued .IOC. 

Queued .IOC. is being developed to make viable the use of BCS 
type operating system in the I/O processor of an HP2000 ACCESS 
system. However, Queued .IOC. need not be restricted to this use. 
This dccument will deal primarily with the features of Queued 
•IOC. which are different from current versions of .IOC. 
Heference to existing documents en BCS and .IOC. is suggested for 
answers to questions not covered here. 

II. Design Overview 

Objectives 

The major goal for Queued .IOC. is to generate a group of new 

P£Jsi2S3l services which will enable BCS to function in an 

environment having time dependencies and a requirement for 
priority handling of events. 

Queued .IOC. will require an equipment table (EQT) of larger 
size than previous versions of .IOC. The special microcode 
developed for use in the IOP software of the HP200C ACCESS systems 
is also required. 

fiSSian summary 

Queued .IOC. will be modular in organization. The functions 
to be performed by Queued .IOC. are very distinct so that 
modularity is quite natural. In addition, processing which is 
common to several functions can be implemented as subroutines. 
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Three primary nodules will exist. First is the nodule 
associated with the .IOC. entry point. This nodule receives 
control fron the user progran and processes the request 
appropriately* Secondary nodules will process the various types 
cf requests — read, write, control, status, etc. Several of 
these nodules will process the request directly or queue it for 
later processing by the I/O driver. In other cases the I/C driver 
will be entered to process or start processing the request. 

The second prinary nodule is that associated with the . BOFR 
sntry point. Here the conpleted requests nay be placed on a 
prioritized queue with other conpleted requests (the CBQ or 
conpleted request queue) • If another operation has been requested 
and queued for the device, it will be initiated at this point. 

The third prinary nodule is that associated with the .UNS. 
sntry point. .ONS. allows a driver to place into the conpleted 
request queue, an entry containing infornation about sone 
unsolicited asynchronous evert. Such events are unsolicited in 
that no .IOC. call brings then about. (An exanple night be the 
receipt of a BREAK character fron a connunications line.) By 
placing such events into the conpleted request queue, infornation 
can be passed back to the user progran for action at that level. 

ll2iL °J control 

It is inperative that the capabilities available to the user 
progran through Queued .IOC. be understood. A sunnary of the 
capabilities fellows. 

Perhaps nost inportant is the fact that all capabilities 
fornerly available through ncn-buffered .IOC. are still available 
and in an identical fern. Ihis is also true of buffered .IOC. 
with the exception that nultiple put fe reg output requests will not 
be possible with Queued .IOC. A reading of the renainder of this 
section will reveal that nultiple output requests can be dene but 
in a slightly different manner. 

A significant new capability exists to allow scheduling of 
multiple read, write, or control requests. Coupled with this is 
the ability . to handle the conpleticn of these requests on a 
priority basis. The flow of control is as follows-- 

1. The calling progran uses an .IOC. parameter word having 
bit 15 set to indicate a queued request . (May be read, 
write, or control.) 



2-2 



2. For .reads and writes, the buffer supplied for the call 
is assumed to be preceded by 5 quaueing and control 
words for use by Queued iioc. 

3. The •IOC, call is made. •IOC. may enter the I/G driver 
immediately (if the driver is idle) or queue the 
request for later processing by the driver. This 
latter queue is referred to as the device reguest queue 
or DRQ. 

Certain specialized I/O drivers do not dapend on the 
device reguest queue but handle queueing of multiple 
reguest.s themselves. An example is the D. 51 

multiplexer driver. The EQT associated with such a 
driver is marked as using no device request queue. All 
requests are immediately presented to the driver in 
this case. (See the section entitled "Self-queuing I/O 
drivers" elsewhere in this document.) 

4. The driver completes the reguested operation and exits 
through .BOFR (an entry point in .IOC). 

5. . B0FR places the completed request into the completed 
request^ueue. This queue is arranged in priority 
order. The logical unit number is used as a default 
priority. However, the priority for a given completed 
reguest may optionally be selected by the user program. 
This capability is discussed below. 

6. The user program uses an interrogate request to inspect 
the completed request- queue. In this way the 
observance of the completed request is made. 

Since available DMA channels are shared by all I/O drivers 
needing DMA, contention for these channels exists. An I/O driver 
which needs DMA but which is unable to acquire a DMA channel will 
reject the I/O call with tha B register set to 1 (DMA needed but 
unavailable). For queued reguests only, Queued .IOC. will 
resolve this conflict. A reject of this sort will cause the I/O 
operation to remain queued and the EQT to be marked with a flag 
indicating "wait for DMA." As 'other I/O operations complete, 
Queued .IOC. will note the availability of DMA channels and will 
reschedule an EQT suspended for this reason. Note that ncn-queuad 
I/O requests are not handled in this manner and will still result 
in the traditional reject at the .IOC. call. 

The interrogate request is a special .IOC. call which asks 
for notification of a completed request or unsolicited event. The 
unit reference number in this .IOC. call designates the lowest 
priority to be inspected. Ic ether words, if it is desirad to 
inspect for completed requests at priority x or higher (<x) , then 
x is the unit reference number used in the .IOC. call. A 
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rejection return is used to indicate that no completed reguests at 
the designated priorities ware found. For a successful return, 
registers are set to supply information about some completed 
request or unsolicited event. 

Three other capabilities exist. One allows the user program 
to supply the address of a subroutine which .BOFR will use to 
choose ths priority at whicfc a completed request is to be queued. 
Between steps U and 5 noted above, this subroutine is activated. 
The priority it returns for the completed re guest will over-ride 
the default priority (logical unit number) for the device. 
Another capability allows a device request gueue to be purged. 
All pending requests are immediately moved to the completed 
request queue. Finally, an ,IOC, call is available to activate a 
device reguest gueue which has been suspended due to an I/C error. 
Such suspension is indicated as necessary to • IOC, whenever an I/O 
driver indicates a need for operator attention in the EQT status 
word, 

III. Design Structure 

2l2SlAZ££i°JL oj; queues 

Queued .ICC. is concerned with two gueues. One is the Device 
Request Queue (DRQ), and the other is the Completed Bequest Queue 
(CRQ). 

For each EQT, a DRQ can be maintained to hold multiple I/O 
requests for the unit. The organization of the DRQ is based on 
two things. One is a word in the EQT called the DRQ head. It 
holds the address of the current reguest. The second thing is the 
set of five queue control words associated with each request to be 
queued. For read or write requests these control words are 
provided by the user program, (See "Buffer use with queued 
requests" under the section en "Data formats and .IOC. calls".) 
For control requests the control words are obtained by .IOC, 
Using the DRQ head and the five control words, the DBQ is 
organized as shown in the illustration on the next page. 

The CRQ has a very siailar organization. The CRQ head is 
location within the .IOC. lodule which addresses the highest 
priority completed reguest. Other completed requests are then 
chained in priority order, Ihe same five control words used for 
requests on the DRQ are used for the CRQ. CRQ organization is 
also illustrated on the next page. 

As shown in the illustration, the first of the queue control 
words is used to link requests together. The appropriate head 
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addresses the feist request and each request in turn addresses its 
successor. The last request has a zero link word. In the case of 
tha CRQ, the priority of the request is stored in another of the 
five words (the last). 
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Il lustr a tion of queue or ganization 



EQT 
r — • — ----., 



DBC 
Head 



I | (current request) 

l— -------- ——-— - 



I | (3rd request) 
c— ------------- -- 



| | (last request) 

L------ — -— -------- 



I | (2nd request) 

L— - — — — ------ 



Link 
words 



Entry 
priority 
(a<b<c<d) 



I CRC 
| Head 

L--- — — 



| | (3rd request) | c | 



j | (last request) | d | 



| | (2nd request) | b | 

L-- — - — — - — — —- — -- — ... 



I I (top request) | a | 

L- — -- — — — ------------ 
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QUEUED IOC 



QUEUED .IOC. IS THE INPUT/OUTPUT CONTROL ROUTINE WITHIN THE I/O 
SUBSYSTEM. IT IS RESPONSIBLE FOR THE SCHEDULING OF I REQUESTS 
ANO THE NOTIFICATION OF THE COMPLETION OF THESE REQUESTS. THE 
FOLLOWING TWO QUEUES ARE MAINTAINED BY QUEUED .IOC TO AID THE 
SCHEDULING OF THESE TASKS: 

DEVICE REQUEST QUEUE (DRQ) 

FOR EACH QUEUING DRIVER EQUIPMENT TABLE (EOT). A DEVICE REQUEST 
QUFUE IS MAINTAINED TO HOLD MULTIPLE I/O REQUESTS EACH DEVICE 
REQUEST QUEUE HAS A DRQ HEAD (EOT WORD 4) WHICH CONTAINS THE 
ADDRESS OF THE CURRENT I/O REQUEST AND A LINKED LIST OF FIVE 
QUEUE CONTROL WORDS ASSOCIATED WITH FACH REQUEST TO BE QUEUED. 
FOR CONTROL REQUESTS THE QUEUE CONTROL WORDS ARE OBTAINED BY 
THF .IOC. SUBROUTINE VIA A CALL TO .GET. FOR READ AND WPITE 
PFQUFSTS THE CONTROL WORDS ARE SUPPLIED BY THE CALLING MODULE 
AS FOLLOWS! 

EACH READ AND WRITE REQUEST HAS A BUFFER ASSOCIATED 
WITH IT. A BLOCK OF NINE BUFFER CONTROL WORDS BCW 
WORDS) IS ATTACHED TO THE BEGINNING OF EACH BUFFER. 
BCW WORDS 5 THROUGH 9 ARE USED BY .IOC. AS THE SET 
OF DRQ CONTROL WORDS. 

THE DRQ QUEUE CONTROL WORDS ARE DEFINED AS FOLLOWS 
WORD (BCW WORD 5) - QUEUE LINKAGE 

WORD 1 (BCW WORD 6) - .IOC. I/O REQUEST PARAMETER 
WORD 2 (BCW WORD 7) - BUFFER SIZE (N/A FOR CONTROL REQUESTS) 
WORD 3 (BCW WORD 8) - NOT USED 
WORD 4 (BCW WORD 9) - NOT USED 



COMPLETED REQUEST QUEUF (CRQ) 

THE CRQ IS A PRIORITIZED QUEUE OF ALL COMPLETED I O REQUESTS ANO 
OF. ALL UNSOLICITED EVENT REQUESTS (UNSOLICITED IN THAT NO .IOC. 
CALL BRINGS THEM ABOUT). THE CRQ HEAD IS LOCATED WITHIN .IOC. 
ANO IT CONTAINS THE AODRESS OF THfe HIGHEST PRIORITY CRQ ENTRY. 
OTHER PEQUESTS ARE LINKED IN PRIORITY ORDER'. THE SAME FIVE 
QUEUE CONTROL WORDS USED FOR DRQ ENTPIES ARE USED FOR CRQ 
ENTRIES. QUEUE CONTROL WORDS FOR UNSOLICITED EVENTS ARE OBTAINED 
BY THE -UNS. MODULE VIA A CALL TO .GET. THE COMD L eTION PRIORITY 
OF A CRQ ENTRY FOR SOLICITED EVENTS IS THE UNIT REFERENCE NUMBER 
OF THE DEVICE FOR WHICH THE ENTRY IS BEING MADE. THE COMPLETION 
PRIORITY FOR UNSOLICITED EVENTS CAN BE SPECIFIED BY THE CALLING 
DRIVER OR THE UNIT REFERENCE NUMBER CAN BE USED AS A DEFAULT 
PRIORITY. (SEE .UNS. DESCRIPTION) THE CRQ CONTPOL WORDS ARE 
DFFINED AS FOLLOWS: 
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ALL CRO ENTRIES EXCEPT UNSOLICITED EVENTS 
WORD (BCW WORD 5) - QUEUE LINKAGE 

WORD 1 (BCW WORD 6) - .IOC'. I/O REQUEST PARAMETER 
WORD ? (BCW WORD 7) - TRANSMISSION LOG FROM EOT WORD 2 
WORD 3 (BCW WORD 8) - STATUS FROM EOT WORD 1 
WORD 4 (BCW WORD 9) - COMPLETION PRIORITY 

CRQ ENTRIES FOR UNSOLICITED EVENTS 
WORD - QUEUE LINKAGE 

WORD 1 - TSB LOGICAL UNIT NUMBER/UNIT REFERENCE NUMBER 
WORD P - NOT USED 
WORD 3 - EVENT DATA 
WORD 4 - COMPLETION PRIORITY 

A CRQ ENTRY IS RECOGNI7ED AS BEING FOP AN UNSOLICITED 
EVENT BY THE FACT THAT THE COMMAND BITS OF CRO WORD 1 
(BITS 14:12) ARE 7ERO. IN THIS CASE CRQ WORO CONTAINS 
THE EVENT DATA WHICH IS DEFINED BY THE DRIVER PRESENTING 
THE UNSOLICITED EVENT. 
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QUEUED .IOC. IS MADE UP OF THREE PPlMARY MODULES ANO THEIR 
SUPPORTIVE SUBROUTINES. EACH MODULE HAS AN EXTERNAL ENTRY 
POINT. A DESCRIPTION OF THE WORK PERFORMED BY THESE BIG 
THREE FOLLOWS: 



• IOC. 

« 

THIS MODULE RECEIVES CONTROL FROM CALLING HANDLERS TO PROCESS 
VARIOUS TYPES OF I/O PEOUESTS SUCH AS READING, WRITING, CONTROLt 
STATUS* ETC. SOME REQUESTS ARE IMMEDIATELY PROCESSED BY .IOC. 
AND OTHERS RESULT IN A CALL TO THE APPROPRIATE I/O DRIVER FOR 
PROCESSING. IN ADDITION .IOC. IS RESPONSIBLE FOR QUEUING REAO, 
WRITE* ANO CONTROL REQUESTS TO BUSY, QUEUING I/O DRIVERS ON THE 
DEVICE REQUEST QUEUE (DRQ) . SELF-QUEUING DRIVERS ARE ALWAYS 
CALLED AS THEY MAINTAIN THEIR OWN QUEUES. THESE QUEUED ENTRIES 
WILL BE RESCHEDULED BY .IOC. AFTER THE DRIVER BECOMES NOT-BUSY. 

WHEN A BUSY DRIVER COMPLETES AN I/O OPERATION, IT CALLS .BUFR 
AS ITS LAST ACTIVITY PRIOR TO EXITING (AND THUS BECOMING NOT- 
BUSY). ONE OF THE OPERATIONS '.BUFR PERFORMS IS TO CHECK THE 
DRQ OF EACH DRIVER THAT COMPLETES AN I/O REQUEST'. IF ANY EVENT 
IS QUEUED, .BUFR WILL SET THE "PENDING DRQ ACTIVITY FLAG (P FLAG) 
IN THE DRIVER«S EQT FLAGS WORD ANO IT WILL INCREMENT THE PENDING 
DPO ACTIVITY COUNTER. ALL .IOC*. CALLS EXIT THROUGH THE COMMON 
ROUTINE, RETN. IF THE PENDING DRQ ACTIVITY COUNTER IS NON-ZERO, 
EVERY EOT IS CHECKED FOR PENOING I/O'. WHEN PENDING ACTIVITY IS 
FOUND, THE P FLAG IS CLEARED AND THE I/O IS INITIATED (SEE .IOC. 
I/O RESCHEDULING) 

•IOC. ALSO MAINTAINS THE SCHEDULING OF DRIVERS WHICH REQUIRE THE 
USE OF DMA. IF AN I/O REQUEST CANNOT BE HONORED BECAUSE THERE 
IS NO FREE DMACHANNAL, ,IOC. WILL SET THE "REQUIRES OMA" FLAG 
(R FLAG) IN THE DRIVER'S EQT FLAGS WORD AND THEN INCREMENT THE 
PENDING DMA ACTIVITY COUNTER. WHEN AN .IOC°. REQUEST EXITS THPOUGH 
RFTN, A CHECK IS MADE OF THE PENDING DMA ACTIVITY COUNTER. IF IT 
IS NON-ZERO AND IF A DMA CHANNEL IS FREE, A ROUND ROBIN SEARCH OF 
THE EQT»S IS MADE FOR ONE AWAITING DMA USAGE*. WHEN ONE IS FOUND, 
ITS R FLAG IS CLEARED AND THE I/O REQUEST IS RE-ISSUED TO THE 
DRIVER. (SEE .IOC. I/O REQUEST RESCHEDULING) 

•IOC. I/O REQUEST RESCHEDULING 

THE DRIVER'S EQT IS CHECKED TO SEE IF IT IS SELF-QUEUING (EQT WORD 0, 
BIT14). IF IT IS SELF-QUEUING, THE DPIVERtS. DRQ HEAD (EQT WORD 4) 
IS CLEARED AND CONTROL IS RETURNED TO THE CALLER, HENCE SELF-QUEUING 
DRIVERS MUST NOT ONLY SCHEDULE THEIR OWN I/O REQUESTS THFY MUST ALSO 
RESCHEDULE THEIR OWN PENDING DMA USAGE. OTHERWISE THE I/O REQUEST 
IS RETPIEVED AND THEN SENT TO THE DRIVER. NORMALLY THE DRIVER WILL 
RETURN BUSY AND THEREFOR I/O REQUEST RESCHEDULING IS DONE. IF THE 
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REQUEST IS REJECTED* THE BUFFER IS MARKED AS PURGED EOT WORD 1 = 
140377), THE ENTRY IS REMOVED FROM THE DRQ AND PLACED ON THE CRQ* 
AND THE DRQ IS SUSPENDED (EQT WORD 1, BIT13=1>. IF THE REQUEST 
IMMEDIATE COMPLETES* THE ENTRY IS REMOVED FROM THE ORQ AND PLACED 
ON THE CRQ. IF ATTENTION IS REQUIRED (EQT WORD 1, BIT14sl)f THE DRQ 
IS SUSPENDED. OTHERWISE* THE DRQ HEAD IS AGAIN CHECKED FOR MORE 
^ENDING I/O. IF THE DRQ IS NOT EMPTY. THE CYCLE WILL RESTART. 



.IOC. REQUEST PARAMETER 

A SINGLE WORD PARAMETER IMMEDIATELY FOLLOWING THE JSB TO .IOC. 

DEFINES THE TYPE OF I/O REQUEST AND DEVICE TO BE USED IT HAS 
THE FOLLOWING FORMAT: 



15 14 12 11 6 S 

Q : FUNCTION : SUBFUNCTION ; UNIT 



REFERENCE 



Q= 



QUEUED REQUEST INDICATOR 

1 REQUEST IS TO BE QUEUED FOR PROCESSING BY THE 
I/O DRIVER'. THIS INCLUDES SUBSEQUENT QUEUING 
OF THE OPERATION IN THE COMPLETED REQUEST 
QUEUE WHEN DRIVER PROCESSING IS FINISHED. 

NO QUEUING OF THE I/O REQUEST AS IT IS TO BE 
PROCESSED IMMEDIATELY BY THF DRIVER. 

NOTE? MIXED USE OF QUEUED AND NON QUEUED REQUESTS 
WILL RESULT IN REJECTION OF THE REQUEST BY 
•IOC. MIXED USE IS POSSIBLE ONLY IF ALL 
REQUESTS FOR THF. DRIVER HAVE BEEN COMPLETED. 
ONLY READ. WRITE* AND CONTROL REQUESTS CAN 
BE QUEUED'. 
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FUNCTIONS 



A NUMERIC VALUE INDICATING A GENFRAL CLASS OF 
PROCESSING, LEGAL VALUES ARE: 

CLEAR 

1 READ 

2 WRITE 

3 " CONTROL 

4 STATUS 

5 INTERROGATE COMPLETED REQUEST QUEUE 

6 SPECIAL 

CLEAR - USED TO TERMINATE I/O AND CLEAR THE HARD- 
WARE INTERFACE. .IOC. ISSUES THE CLEAR REQUEST 
TO THE ORIVER AND AFTER RETURNING IT RELEASES 
ANY PENOING DMA USAGE AND PURGES ANY OUTSTANDING 
QUEUED I/O REQUESTS FOP THE DRIVER THIS IS DONE 
RY REMOVING THE ENTRIES FROM THE DRQ» MARKING 
THEM AS PURGED, AND PLACING THEM ON THE CRQ. 

READ - USED TO REQUEST ANY READ OPERATION. .IOC. 
PUTS QUEUED READS ON THE DRIVER »S DRQ AND IF THE 
QUEUE IS EMPTY. IT ISSUES THE READ REQUEST TO THE 
DRIVER. NON-QUEUED READS ARE IMMEDIATELY ISSUED. 
FOR ACTIVITY PERFORMED AFTER THE DRIVER RETURNS TO 
.IOC.» SEE "READ /WRITE/CONTROL REQUEST RETURNS". 

WRITE - USED TO REQUEST ANY WRITE OPERATION. .IOC. 
PUTS QUEUED WRITES ON THE DRIVER S DRQ AND IF THE 
QUEUE IS EMPTY. IT ISSUES THE WRITE REQUEST TO THE 
DRIVER. NON-QUEUED WRITES ARE IMMEDIATELY ISSUED. 
FOR ACTIVITY PERFORMED AFTER THE DRIVER RETURNS TO 
.IOC.t SEE "READ /WRITE/CONTROL REQUEST RETURNS". 

CONTROL - USED TO PERFORM DRIVER DEFINED CONTROL 
OPERATIONS SUCH AS A READER/PUNCH FEED REQUEST. 
.IOC. PUTS QUEUED CONTROL REQUESTS ON THE DRIVER'S 
DRQ AND IF THE QUEUE IS EMPTY. IT ISSUES THE 
CONTROL REQUEST TO THE DRIVER*. NON QUEUED CONTROL 
REQUESTS ARE IMMEDIATELY ISSUED TO THE DRIVER. 
FOR ACTIVITY PERFORMED AFTER THE DRIVER RETURNS TO 
.IOC.» SEE "READ/WPITE/CONTROL REQUEST RETURNS". 

STATUS - USED TO OBTAIN THE LAST RECORDED STATUS 
FOR A DEVICE". .IOC. RETURNS WITH 

A = STATUS (EQT WORD 1) 

P a TRANSMISSION LOG (EQT WORD 2) 

INTERROGATE - USED BY THE COMMUTATOR TO INTERROGATE 
THE COMPLETED REQUEST QUEUE". FOR A COMPLETE 
DESCRIPTION SEE ulNTERROGATION REQUESTS". 
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SPECIAL - USED TO PERFORM UNIQUF. OPERATIONS 
WHICH ARE DETERMINED BY THE SUBFUNCTION. THESE 
OPERATIONS ARE: 

PRIORITY APPENDAGE - USED TO SUPPLY .IOC, THE 
ADDRESS OF A MODULE TO BE USED TO DETERMINE 
THE PRIORITY AT WHICH A COMPLETED I/O REQUEST 
IS TO BE PLACED ON THE CRO*. IOC. RETRIEVES 
THE APPENDAGE ADDRESS AND PLACES IT IN EQT 
WORD 5. 

1 PURGE - USED TO REMOVE QUEUED REQUESTS FOR A 
DRIVER. THE PURGE REQUEST IS SENT TO THE 
DRIVER AND UPON RETURN. ANY PENDING DMA USAGE 
IS RELEASED AND ALL PENDING I REQUESTS ARE 
PURGED BY REMOVING THEM FROM THE DRIVER'S DRQ, 
MARKING THEM AS PURGED. AND PLACING THEM ON 
THE CRQ. PURGE DOES NOT INCLUDE CLEARING THE 
HARDWARE INTERFACE. 

2 RELEASE - USED TO ACTIVATE A SUSPENDED DEVICE. 
SUSPENSION OCCURRS WHEN A DEVICE TERMINATES AN 
OPERATION WITH AN INDICATION THAT SPECIAL 
ATTENTION IS REQUIRED'. IF THE DRQ IS NOT 
SUSPENDED. NO ACTION IS TAKEN IF IT IS 
SUSPENDED. THE SUSPENSION BIT IS REMOVED (EQT 
WORD 0, BITl3=01. THEN IF THERE IS AN I/O 
REQUEST ON THE DRQ. IT IS ISSUED TO THE 
DRIVER. IF THE REQUEST IMMEDIATE COMPLETES 
WITHOUT ATTENTION NEEDED, THE DRQ IS AGAIN 
CHECKED FOR MORE ENTRIES ANO THE CYCLE IS 
REPEATED. 

SUBFUNCTIONs A NUMERIC VALUE INDICATING OPTIONS FOR THE 

FUNCTION. THESE OPTIONS ARE ALL DRIVER DEFINED 
EXCEPT FOR THE SPECIAL FUNCTION AND THE 
FOLLOWING UNIQUE FUNCTION/SUBFUNCTION COMBINATIONS: 

0/0 SYSTEM CLEAR* 
4/0 SYSTEM STATUS* 
3/0 DYNAMIC STATUS 

♦ MUST ALSO HAVE A UNIT REFERENCE OF 0. 

SYSTEM CLEAR - USLD TO TERMINATE ALL DRIVER I/O AND 
PURGE ALL PENDING I/O REQUESTS'. 

SYSTEM STATUS - USED TO DETERMINE IF ANY DEVICES 
ARE ACTIVE. .IOC. WILL RETURN WITH THE A-REG* 
BIT15 = 1 IF AT LEAST ONE DEVICE IS BUSY. 

DYNAMIC STATUS - USED TO OBTAIN THE ACTUAL CURRENT 
DEVICE STATUS'. IF THE REQUEST IS NON-PRIORITY 
(I/O REQUEST. BITq-n). THE REQUEST IS PUT ON THE 
DRQ AND THE COMPLETION IS PUT ON THE CRQ. PRIORITY 
DYNAMIC STATUS REQUESTS ARE NOT PUT ON EITHER 
QUEUE. 
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NOTE: BIT 9 OF QUEUED READ, WRITE OR CONTROL 
REQUESTS INDICATES PRIORITY'. SUCH A REQUEST WILL 
8E QUEUED IN FRONT OF CURRENT REQUESTS. 



UNIT REFERENCES A NUMBER USED TO REFER TO A SPECIFIC DEVICE. 



READ/WRITE/CONTROL REQUEST RETURNS 



WHEN A CALLED DRIVER RETURNS TO .IOC. AFTER PROCESSING A READ* WRITE* 
OP CONTROL REQUEST* THE A AND B REGISTEPS CONTAIN STATUS INFORMATION 
WHICH RESULTS IN THE FOLLOWING ACTION; 



A-REG B-REG 
1 BIT0=0 
I BIT0=1 

PITlSsl 




MEANING 
(DRIVER REJECT RETURN) 
(DMA REQUIRED RETURN) 
(IMMEDIATE COMPLETION RETURN 
(NORMAL RETURN) 



QUEUED DRIVERS MAKING QUEUED REQUESTS 

(DRIVER REJECT RETURN) - THE DRIVERS EQT STATUS WORD IS 
FLAGGED AS REQUEST REJECTED (EQT WORD 1 a 140177 THE. REQUEST 
IS REMOVED FROM THE DRQ AND IS PLACED ON THE CRQ THE ORQ IS 
THEM SUSPENDED (EOT WORD 0* BIT 1*1 si). CONTROL IS RETURNED 
TO THE CALLER. 

(DMA REQUIRED RETURN) - THIS DRIVER IS SCHEDULED FOR DMA 
USAGE BY SETTING THE "REQUIRES DMAm FLAG (R FLAG IN HIS EQT 
FLAGS WORD (EQT WORD 0* BIT \? = \) AND THEN CONTROL IS 
RETURNED TO THE CALLER. 

(IMMEDIATE COMPLETION RETURN) - THE REQUEST IS REMOVED FROM 
THE DRQ AND IS PUT ON THE CRQ. THE DRIVER tS EQT STATUS IS 
CHECKED FOR REQUIRED ATTENTION (EQT WORO 1. BIT1 IF ATTENTION 
IS REQUIRED (BIT = 1) THE DRQ IS SUSPENOED (EQT WORD 0* BIT13=1). 
CONTROL IS THEN RETURNED TO THE CALLER. 

(NORMAL RETURN) - CONTROL IS RETURNFD TO THE CALLER. 

SELF-QUEUING DRIVERS AND NON-QUEUED REQUESTS 

(DRIVER REJECT RETURN) - CONTROL IS RETURNED TO THE CALLER 
AT HIS .IOC. REQUEST REJECT RETURN POINT". 



(DMA REQUIRED RFTURN) 



SAME AS DRIVER REJECT RETURN. 



(IMMEDIATE COMPLETION RETURN) - CONTROL IS RETURNED TO THE 
CALLER. 
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(NORMAL RETURN) - CONTROL IS RETURNED TO THE CALLER. 



INTERROGATION REQUESTS 

THE COMMUTATOR USES THIS REQUEST TO INTERROGATE THE COMPLETED REQUEST 
QUEUE. EACH DRIVER IN THE I/O PROCESSOR HAS AN .IOC INTERROGATION 
REQUEST CALLING SEQUENCE IN THE COMMUTATOR', THE UNIT REFERENCE 
NUMRER» CONTAINED IN THE .IOC. I/O REQUEST PARAMETER REPRESENTS THE 
LOWEST PRIORITY TO BE EXAMINED IN THE CRQ. THE HIGHEST PRIORITY 
COMPLETED REQUEST OR UNSOLICITED EVENT IS AT THE TOP OF THE CRQ. 
IF THIS ENTRY«S PRIORITY IS NOT EQUAL TO OR GREATER THAN THE UNIT 
REFERENCE NUMBER IN THE INTERROGATION REQUEST. .IOC WILL TAKE THE 
REJECT RETURN. IF THE REQUEST IS SUCCESSFUL* THE ENTRY IS REMOVED 
FROM THE CRQ AND THE NOPMAL RETURN IS TAKEN WITH THE FOLLOWING 
INFORMATION IN THE A AND B REGISTERS: 

COMPLETED REQUEST ENTRY UNSOLICITED EVENT ENTRY 

A-REG I/O REQUEST PARAMETER BIT 15 SYSTEM OVERLOAD FLAG 

14-1? ZERO 

11-6 TSB LOGICAL UNIT NUMBER 
5-0 UNIT REFERENCE NUMBER 
B-REG BUFFER ADDRESS EVENT DATA 

NOTE: THE SYSTEM OVERLOAD FLAG IS SET IN THE EVENT THAT 
ALL AVAILABLE SYSTEM QUEUE SPACE IS IN USE'. THE FLAGGED 
ENTRY WAS OBTAINED FROM EMERGENCY STORAGE AND INDICATES 
THAT SOME SUBSEQUENT UNSOLICITED EVENTS MAY HAVE BEEN LOST. 



2-14 



.BUFR 

THIS MODULE IS CALLED FROM THE CONTINUATOR SECTION OF ALL DRIVERS 
WHEN AN I/O REQUEST HAS COMPLETED*. IF THE REQUEST WAS NOT QUEUED 
(PUT ON THE DRIVER'S DRQ) * THE ORG HEAD WILL BE ZERO AND A RETURN 
TO THE CALLING DRIVER IS IMMEDIATELY MADE. ( HOWEVER SELF-QUEUING 
DRIVERS CAN MAKE USE OF THE CRQ BY FOLLOWING THE STEPS OUT-LINED 
IN THE SECTION "SELF-QUEUING I/O DRIVERS.) OTHERWISE THE REQUEST 
IS PLACED ON THE CRQ AND IS REMOVED FROM THE DRQ°. 

THE EOT FOR THE COMPLETED I/O REQUEST IS NOW CHECKED IF THE EQT 
INDICATES THAT THE DRIVER IS SELFIqUEUING (EQT WORD BITl^sl), 
THE DRQ HEAD (EQT WORD 4) IS SET TO ZERO AND CONTROL IS RETURNED 
TO THE CALLER. FOR A QUEUING DRIVER THE EOT STATUS IS CHECKED. 
IF THE EQT STATUS INDICATES THAT ATTENTION IS NEEDED EQT WORD It 
HITl4=l)t THE DRQ IS SUSPENDED (EQT WORD 0. BIT13« AND .BUFR 
WILL RETURN TO THE CALLER. OTHERWISE, THE DRIVER »S DRQ IS CHECKED 
FOR ANY PENOING I/O REQUESTS. IF THE DRQ HEAD IS ZERO* .BUFR WILL 
RETURN TO THE CALLER. IF THE DRQ HEAD IS NOT ZERO THE "PENDING 
DRQ ACTIVITY" FLAG IS SET IN THE EQT FLAGS WORD (EOT WORD Of 
RIT11=1) ANO THE PENDING DRQ ACTIVITY COUNTER IS INCREMENTED. 
CONTROL IS THEN RETURNED TO THE CALLER. 
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SELF-QUEUING I/O DRIVERS 

A SELF-QUEUING I/O DRIVER IS ONE ASSOCIATED WITH AN EOT HAVING BIT 
14 OF EQT WORD SET. SUCH AN I/O DRIVER IS UNIQUE IN THAT NO I/O 
REQUEST IS EVER QUEUED FOR IT BY QUEUED . IOC*. THAT IS* NO DRQ IS 
MAINTAINED. INSTEAD, ALL I/O REQUESTS ARE IMMEDIATELY PASSED TO 
THE DRIVER AND IT MUST MAINTAIN ITS OWN REQUEST QUEUING INTERNALLY. 
THIS DEFINITION IS TO ALLOW FOR DRIVERS WHICH HANDLE MULTIPLE 
DEVICES* ESPECIALLY MULTIPLE DEVICES SERVICED VIA A SINGLE HAROWARE 
I/O INTERFACE SUCH AS THE HP l?q?0 ASYNCHRONOUS MULTIPLEXER. THIS 
TYPE OF DRIVER DOES NOT WANT THE I/O QUEUING SERVICES OF QUEUED .IOC. 
SINCE REQUESTS MAY BE DIRECTED TO DIFFERENT SUBUNITS OR SUBCHANNELS. 

SELF-QUEUING DRIVERS DO* HOWEVER. HAVE ACCESS TO MOST OF THE 
CAPABILITY OF QUEUED .IOC. SPECIFICALLY* THE COMPLETED REQUEST 
QUEUE AND THE UNSOLICITED EVENT FACILITY ARE AVAILABLE. USE OF 
THE UNSOLICITED EVENT FACILITY REQUIRES NO SPECIAL INFORMATION* 
BUT USE OF THE COMPLETED REQUEST QUEUE MUST BE PLANNED. QUEUED 
.IOC. REQUIRES FIVE WORDS OF STORAGE IMMEDIATELY PRECEDING THE 
BUFFER ASSOCIATED WITH A READ* WRITE. OR CONTROL REQUEST. HENCE* 
IF A NON-QUEUING DRIVER PLANS TO USE THE COMPLETED REQUEST QUEUE* 
I/O REQUESTS TO IT SHOULD* IN TURN. EXPECT THE CALLING PROGRAM TO 
SUPPLY THESE FIVE WORDS. (NOTE THAT INCIDENTALLY THESE FIVE WORDS 

could be used by the i/o driver to perform its own request queuing.) 
with these five words available. the i/o driver can have a request 
added to the completed request queue by performing the following 
steps: 

1. update the eqt with all necessary status and transmission 
log information. 

2. copy the .ioc. request parameter into the second word of 
the five prefix words* (the logical unit number is the 
main requirement.) this should probably be done in the 

INITIALOR SECTION OF THE DRIVER WHEN THE I/O REQUEST IS 
MADE. 

3. PLACE THE ADDRESS OF THE BUFFER (NOT THE ADDRESS OF THE 
FIVE WORD PREFIX) INTO EQT WORD 4 (THE DRQ HEAD). 

4. CALL .BUFR IN THE NORMAL WAY. 
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. U N « . 

THIS MODULE IS CALLED BY DRIVERS FOR UNSOLICITED EVENT NOTIFICATION 
PROCESSING. .UNS. CALLS .GET TO OBTAIN THE FIVE QUEUE CONTROL WORDS 
NECESSARY FOR COmd L eTED REQUEST QUEUE ENTRIES. IF NO MORE SPACE IS 
AVAILABLE* .UNS. WILL ATTEMPT TO USE THE FIVE WORDS OF EMERGENCY 
STORAGE. IF THIS TOO IS UNAVAILABLE, THE LOST ENTRY COUNTER IS 
BUMPED AND THE ENTRY IS IGNORED. ONCE THE ENTRY STORAGE IS OBTAINED. 
•UNS. WILL BUILD THE CRQ ENTRY AND INSERT IT ON THE CRQ ACCORDING 
TO ITS COMPLETION PRIORITY. THE COMPLETION PRIORITY CAN BE COMPUTED 
PY A SPECIAL DRIVER SUPPLIED PPIORITY APPENDAGE (SEE BELOW) OR IT CAN 
BE SUPPLIED 8Y THE CALLING DRIVER OR THE DEFAULT PRIORITY CAN BE 
REQUESTED BY SUPPLYING A PRIORITY OF OCTAL 77. THE DEFAULT PRIORITY 
WILL BE THE DRIVER'S UNIT REFERENCE NUMBER - . AFTER ENQUEUING THE CRQ 
E^TRY, .UNS. WILL RETURN CONTROL TO THE DRIVER*. 



PRIORITY APPENDAGE 



IF A PRIORITY APPENDAGE IS ESTABLISHED FOR A GlVEn DEVICE* IT WILL 
RF ENTERED AS A SUBROUTINE WHENEVER AN OPERATION FOP THE DEVICE 
COMPLETES. WHEN THE ROUTINE IS ENTERED. THE A Amo B REGISTERS WILL 
CONTAIN THE FOLLOWING INFORMATION? 

A-REG s ADDRESS OF BUFFER 
B-REG = AOQPFSS OF EOT 

THF ROUTINE IS EXPECTED TO RETURN WITH THE A-REGISTFR CONTAINING 
THE PRIORITY AT WHICH THF «UFFER IS TO BE PLACED ON THF COMPLETED 
REQUEST QUEUE. ZERO IS THF HIGHEST PRIORITY AND OCTAL 77 IS ThE 
LOWEST PRIORITY. 

A PPIORITY APPENDAGE IS ESTABLISHED PY MAKING AN .IOC PRIORITY 
APPENDAGE REQUEST WITH THE ADDRESS OF THE APPFNHAGE SUPPLIFD AS 
A PARAMETER. AN ADDRESS OF 7ERO WILL DEACTIVATE THE PRIORITY 
APPENDAGE. 
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F Q T TABLE 



15 14 13 12 11 10 9 8 



o:d:n;s:p:p: .: sub-channel channel : 



15 14 13 8 7 

■■ — 1111 — 1 M M Ml — Mill ■■■ M , M M M , H »■ MM M M ,,,,„,, , „ — — m , ., „ ., |. || 1 :' f <* 

1 : A : I STATUS 



15 14 

? ! M : TRANSMISSION LOG 



15 



driver address 



15 



DEVICE REQUEST QUEUE HEAD 



15 
5 : PRIORITY APPENDAGE ADDRESS 



WORD D - DIRECT MEMORY ACCESS CHANNEL INDICATOR 

1 DMA REQUIRED FOR ALL DATA TRANSMISSIONS 

DMA NOT REQUIRED 

N - NON-QUEUING INDICATOR 

1 NO DEVICE REQUEST QUEUE IS USED. THE 
I/O DRIVER ACCEPTS ALL I REQUESTS 
IMMEDIATELY 

A DEVICE REQUEST QUEUE IS TO RE 
MAINTAINED BY '.IOC. 

S - DRQ SUSPENSION INDICATOR 

1 DEVICE REGUEST QUEUF IS SUSPENDED 

DEVICE REQUEST QUEUE IS NOT SUSPENDED 
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p - 



wopc- i 



p - 



SUB-CHANNEL 
CHANNEL - 

A - 



STATUS - 



PE QUI RES DMA INDICATOR 

1 THE DRG IS SUSPENDED BECAUSE A DMA 

CHANNEL IS NEFDEO HUT WAS NOT AVAILABLE 
AT THE TIME THE DRIVER WAS ENTERED 

THE ORG IS NOT SUSPENDED FOR DMA 

PENDING ORG ACTIVITY 

1 THE DRIVER IS NO LONGER BUSY AND SO THE 
I/O REQUEST ON TOP OF THE DPO CAN BE 
INITIATED 

THERE IS NO. PENDING DPO ACTIVITY 

THE UNIT NUMBER OF A DEVICE ON A MULTI- 
OEVICE CONTROLLER 



THE CHANNEL NUMBER 
DEVICE INTERFACE 



(SELECT CODE) FOP THE 



AVAILAHLILI 

AVAILA 
W I THOU 

1 AVAILA 
WIT*; fc 

2 NOT AV 
1 PURGED 

THF LA 
WAS PE 
CRQ OR 
WERE P 
EN TRIE 
CONTAI 



TY OF DEVICE: 

fcLfc" - PPFVIOUS OPERATION COMPLETE 

T FPPOP 

PLE - PREVIOUS OPERATION COMPLETED 

PROP 

ARABLE - I/O PFOUEST IN PROGRESS 

RE GUEST - THE DRIVER REJECTED 
ST I/O PF QUEST AND THE PEOUEST 
MOVED - FROM Tf-E ORG Akjp, put ON THE 

*t.L T/O REQUESTS FOR THIS DEVICE 
URGED. IN EITHER EVENT* THE CPQ 
S FOR PURGFD I/O PEOUESTS WILL 
N A COPY OF This STATUS 



STATUS OF THE hfcVlCP'. IF THE AVAILABILITY 
VALUE IS •*• THE STATUS wTLL RE 7*-"po IP THE 
REQUEST WAS PUftGEO OR IT WILL BE 77 IF THE 
REQUEST WAS REJECTED 



WORT) P. M - MOOE OF TRANSMISSION 

1 HINARY 
ASCII 0» ^CD 
TRANSMISSION LOG - NUM6tk 
TRANSMITTED 



OF CHARACTERS OR WORDS 



WORD 3 DRIVER ADDRESS - AHSOLUTt 
I/O DIVEW 



ADDRESS OF This DEVICE'S 



WORD 4 DEVICE REQUEST QUEUE HE-. AD - ADQPPSS OF CUPRENT HijrFFw 

REING PROCESSED IF QUEUED REQUEST E0« QUEUING DRIVER. 
THIS ADDRESS MUST ^€ SUPPLIED RY SE.LF-OUEU ING DPT VERS 
IF THE REQUEST IS TO HE PL.ACFD ON THE COMPLETED 
REQUEST QUEUE. 



2-19 



WORD 5 PRIORITY APPENDAGE ADDRESS - THE, ABSOLUTE ADDRESS OF 
THE PRIORITY APPENDAGE ROUTINE*. 
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PFPUEST DESCRIPTIONS: 

- DATA TRANSMISSION (READ/WRITE) 
FUNCTIONS = 1/? 

(P) JSP " .IOC. 

( p * 1 ) (0 .FUNCT ION ♦ SUBFUNCT I ON . UNI T > 

(P+2) (REJECT RETURN* 

(P+3) (BUFFER AOORESS) 

(P+4) (BUFFER LENGTH) 

( tf +5) (NORMAL RETURN) 

- FLECTION SELECT 
FUNCTION a T 

(P) JSR .TOC. 

(P+l> ( FUNCT I ON,SU*FUNCT ION. UNIT) 

(P + ?) (REJECT RETURN) 

(P+3) (NORMAL RETUPN) 

- STATUS/CLEAR 

. FUNCTIONS = 4/0 

(P) JSR .IOC. 

(3+1) (FUNCTION*UNTT) 
(P + 2) (NOOK>AL RETURN) 

- INTERROGATION 
FUNCTION = 5 

(P> JSR .IOC. 

(P+l) (FUNCTION, LIMIT) 

(P+?) (REJECT RETURN) 

(3 + ?) (NOP'^L RETURN) 

- PURGE/RELEASE 
FUNCTION = h 

(P) JSR .inc. 

(P+l ) (FUNCTION,SURFUNJCTION.UMT) 

(P+P) (NORMAL RETURN) 
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III. Design Structures 

5l£^al data struct ures 

In the following sections, precise bit-level definitions of 
system-wide or global data structures are given. In the strictest 
sense of the word, only the BCiMs are truly global data structures 
since they are known to virtually every module of the system. 
None of the ether data structures outlined here are known to any 
modules except the system lanagers or supervisory components. 
Hence they are not global* However, because all of these data 
structures are of major importance to the total system design, 
they are gathered together here for completeness and clarity •s 
sake. 

Buffer Co ptroj. Words (BCWs ) 

Nine buffer control words are contained in the first 9 words 
of each buffer, fiords 5 through 8 are required by Queued .IOC. 
for I/O scheduling, but these words may also be used for 
interhandler communication whenever no intervening I/O would 
destroy the contents. Word 9 is used for gueueing and is 
therefore volatile at the interhandler level. However, word 9 may 
be used to communicate between a handler and a driver* fiords 1 
through 4 are used for inter- and intrahandler communication and 
for retaining such fixed information as buffer pool number and 
size. These words are never destroyed by IOC. 

Function 

Handler defined status flags 

Reject 

=0 - accepted 

=1 - message rejected 

Purge 

=0 - no purge 

=1 - message purged 

Interlock 

= - no interlock 

=1 - return buffer to sender 

Handler defined status flags 

Buffer Pool number 



Punction 

(Reserved for future use) 
Data stream id number 
(Reserved for future use) 



word 


1 
Bit <s) 
15-11 
10 




9 




8 




7-4 
3-0 


Word 


2 
Bit (s) 
15-14 
13-8 
7-4 
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3-0 



Word 3 

Word 4 

I 

Word 5 
Word 6 
Word 7 

Word 8 



Bit (s) 

15 

14-0 



Bit (s) 
15-0 



Bit (s) 

15-3 

2-0 



Word 9 



Bit (s) 

15-14 

13-8 



Buffer type indicator 

*0 - no operation 

■1 - write 

*2 - read 

*3 - enable or start 

«4 - disable or stop 

=5 - purge 

»6 - abort or error 

*7 - operator command or directive 

=8 - control operation 

=9 - start error retry operation 

*10-14 - reserved for future use 

*15 - allocated buffer 



Function 

Unused 

Name cf sender* 



Function 

Buffer length (words) 

Used by .ICC, only 

Used by . IOC. only 

Used by .IOC. and by handlers 
to communicate message length 

Used by .IOC. and for inter- 
handler status information 
Function 

Defined by individual handlers 
General error type indicator 
(as used by ASCII files 
handler, et. al.) 
=0 no error 

= 1 not ready condition (type 1 error) 
= 2 read check error (type 2 error) 
=3 data check error (type 3 error) 
=7 end of file 

Used by handlers to communicate 

this information to I/O drivers: 

Function 

Driver specific flags , 

Stream identifiers (to identify 
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cce of several devices controlled 
by a driver such as the 12920 
■ultiplexor driver) 
7-0 Driver specific flags 

Used by the Queue Manager as the 
chain or link word when linking 
buffers onto a work queue 

The appropriate BCH words are set by the sending handler 
before gueueing for another handler. It should be noted that 
•IOC. will not disturb words 1 through 4 of the BCH^s. 

♦The tera M naae w is used for clarity f s sake (See QIT) . Here it 
refers to the address for the QIT entry of the sender. 
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^IJitem Ma nag ers 

In the following sections are discussed the system managers: 
Queue Manager, Buffer Manager, and Allocate/Deallocate Manager. 

Queue Man ager „(QM]l 

Functional descri 4. ion 

The Queue Manager provides the communications link between 
function handlers* Much work created for a function handler is by 
quaue entries, an^ the Queue Manager manipulates the proper queues 
to route commands, messages, etc., in buffers to and frcn function 
handlers. 

JilklSSSLUiS f unctio . n 

The Queue .'.onager has several entry points each supplying a 
service to calling function handlers. The entry points are: 

1. .PUTQ which will enqueue work for a given function handler. 

2. .PRIQ which is the same as .PUTQ except that the entry is 
placed first in the designated queue. 

3. . GETQ u hie': returns a gueue entry for processing to the 
calling hand ''."nr and dequeues the entry. 

4. .SEEQ vhicli is the ease as .GETQ except that the entry is 
not removed -:ron the queue so that on subsequent ; SEEQ, calls 
the same quo- ia entry is returned to the handler. 

5. .POEQ which removes all entries from a queue and returns 
buffers to tae proper lecation. 

All uses oi! the QM depend on identification of a specific 
quaue. The queue in question will be the one whose QIT entry 
address appears in register A. This parameter is referred to as 
the queue name. 

Upon receiving control from a .PUTQ or .PRIQ call, the queue 
manager uses the destination name to access an entry in the QIT. 
The buffer is then chained into the work queue associated aith the 
QIT entry. If the queue was eapty, the prime gate is set , to 
dispatch the function handler that is to process the queue entry. 
If the queue was aot empty, the QM returns to the caller. 

Opon receiving control from a .GETQ call, the Qf. uses the 
calling handler name to dequeue the first entry in the queue. The 
remaining queue depth court is placed in register A, and the 
address of the queue element is placed in register B. In case of 
a .SEEQ call the action is the same as .GETQ except the queue 
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entry is not removed from the gueue. If the designated gueue has 
been purged, both .GETQ and .SEEQ will return this indication with 
a zero value in register B. This is to be considered a "logical" 
work entry. For this reascn, .SEEQ will continue to return this 
indicator until it is relieved via .GETQ. If a gueue entry is not 
present, the prime gate for the calling handler is closed to 
prevent dispatching the handler again, and the handler is notified 
of the empty gueue condition. 

•PURQ uses .GETQ to empty a gueue, routing buffers back to 
the sender (if the BCW word 1 interlock bit is set) , cr freeing 
them through the Buffer Manager. 

l£*gflsc^ng 

Calling Sequences 

1. .PUTQ or .PRIQ 

Calling sequence is: 

Load destination queue name 
Lead buffer address for enqueue 
Call QM 



LDA 


NAME 


LDB 


BUFAD 


JSB 


. PUTQ 



LDA 


NAME 


JSB 


.GETQ 


JMP 


NOQ 


STA 


QCNT 


STB 


BUFAD 



2. .GETQ or .SEEQ 

Calling sequenc3 is: 

Lead calling handler queue name 

Call QM 

No gueue entry available 

Save address of queue elememt 
returned 

Note that if a queue er.try is net available, a return to the 
calling handler is to the word immediately following the jump-to- 
subroutine instruction; when a queue entry is available a skip is 
taken to the second word following the JSB instruction. Cn return 
to the caller, the QM places in Reg A the current depth of the 
queue (number of work entries currently in the queue). 

In case the queue was purged previous to the .GETQ call, 
return is with a skip, how-aver, register B is zero. 
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3. • PURQ 

Calling sequence is: 

LDA NAME Name of gueue to be purged 
JSB .PURQ 

Lo£li 3i£& st^u^tu^es 

The Queue Manager maintains all work queues as linked lists 
chained by address, QIT word one points to the first queue 
element and the link word of that queue element points to the next 
queue element and so on. QI1 word^ two points to the last queue 
element in the linked list. The link word for each element is BCW 
word 9. 



2-27 



gueu e Information Table 1211L 

The Queue Information Table contains one entry for each work 
queue in the system. Generally, one work queue exists for each 
function handler, although irultiple work queues could conceivably 
be associated with a single function handler. It is through these 
queues that one function handler gives work to another via the 
Quaue Manager. 

The term "name" is associated with the address cf a QIT 
antry. A name is obtained from the Allocate/Deallocate Manager 
and is used by a producing function handler to designate the 
consuming or receiving function handler. 

The QIT consists of two segments. First are all of those 
entries which represent non-allccatable resources. The second 
segment consists of all those entries which represent allccatable 
resources. This second segment is ordered by TSB logical unit 
number (not to be confused with logical unit numbers for ICF .IOC. 
calls) • 

Each entry consists of 1 wcrds as follows: 

Word 1 

Bit (s) Function 

15-0 Address of first buffer on the 

work gueue or zero if no work is 
queued. This word may be thought 
cf as the queue head. 

Word 2 

Bit (s) Function 

15-0 Address of last buffer en the 

wcrk gueue or the address of this 
wcrd if no work is queued. This 
wcrd may be thought of as the 
queue tail. 

Word 3 

Bit (s) Function 

15-0 Queue entry count (number of 

buffers on the work queue) 

Word 4 

Bit (s) Function 

15 Allocatable resource flag 

=0 - not allocated 
=1 - allocated 
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14 Queue status flag 

sQ - queue normal 
*1 - queue has been purged 

13-8 .IOC. logical unit number 

7-6 Unused 

5-0 TSB logical unit number 

Word 5 

Bit (s) Function 

15-0 Address of associated handler's 

prime gate 

Word 6 

Bit (s) Function 

15-0 Address of associated handlers 

initialization entry point or zero 
if no initialization is required 

Word 7 

Bit (s) Function 

15-0 Device name (class and number) 

for device associated with this 
QIT (see Allocate/Deallocate flanager) 
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supervisory Compon sn ts 

In the following sections, supervisory components of the 
system are discussed. 



Ei spatc her 

functional SLSSSX- ' fcion 

The Dispatc \«r module is the master interface between queued 
• IOC, the Queuo Onager, and the various function handlers in the 
IOP. The Dispa :her must perform scheduling of function handlers 
in two cases, tjpoa I/O event completion and when primed by the 
Queue Manager • 

In t erf acing 

Punction h.:*. tilers are nodules which perform major processing 
tasks. Usually , : voy are associated with an I/O devices. These 
handlers have t;: > sources of work: completed I/O operations uhich 
they have previo .>ly scheduled and work given to them by other 
handlers via their nork queue. For this reason, handlers have two 
types of entry r. :i.nts in addition to an initialization entry 
point. One in .for dispatching when I/O operations complete, and 
the other is for dispatching when work appears on a aork queue. 
The following aiming conventions for these entry points are used 
whare XXX is a lx.;-,ic module name: 

XXX HP - scheduled cr prime entry 
XXXHC - I/O completion entry 

■The HP entry po'.nt is always entered via JSB. The HC entry point, 
is entered via JiiP. All exits from these modules following a 
dispatch (i.e. antry at either type of entry point) must be done 
with a JMP to tho external symbol . COH. which is the beginning of 
the dispatcher's commutator. 

Processing a Igor It h as 

The Dispatcher has two parts: a commutator and an I/O 
dispatcher. 
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The commutator consists cf several levels of dispatching 
software. Each level has associated with it a software priority. 
The levels of the commutator execute in priority order. At the 
end of the commutator, following the last level, is a JMP back to 
the top of the commutator. Thus the entire IOP system will loop 
in the commutator. As work becomes available, it will, be 
dispatched from its appropriate level by leaving this loop. 

Dispatching software at a commutator level consists of an 
•IOC. completed event request and one or more function handler 
prime gates. ' The .IOC. call removes completed I/O events from 
IOC»s completed. event queue. These are then turned, over to the 
I/O dispatcher. Function handler prime gates are simple two 
instruction sequences of this form: 

GATE RSS 

JSB ENTRY 

The JSB is to a prime entry point in a function handler. The 
"GATE" is generally an RSS instruction to prevent entry to the 
handler. The Queue Manager manipulates this gate, making it 
either an RSS or a- NOP, depending on available work. Th€ gate is 
opened (MOP) when .PDTQ's cr . PRIQ s s of i-:ork are done- and is 
closed (RSS) when the work queue has been emptied via . GETQ's. 
Note that due to the use of the JSB, a handler is able to open- or 
close its own gate. 

The I/O dispatcher receives control from all commutator 
levels whenever a completed I/O event is located. Using the 
logical unit number for the I/O operation* the I/O dispatcher 
performs a table look-up and dispatches the associated handler at 
its I/O completion entry pcitt. 



Local data structures 

Since the system is based on a BCS environment, an .IOC. 
logical unit number is associated with each I/O device. Also, a 
specific function handler vill exist to control each I/O device. 
Therefore, association between the logical unit numbers and the 
function handlers is necessary in order to dispatch the proper 
function handler to process the completed I/O events for ths 
device. .Thus, a table of the function handlsr I/O complete entry 
point addresses is kept. The table is ordered by logical unit 
number and is called the I/O Dispatching Table or IODT. 
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119. Dispat ching Table JI0DT1 

The IODT is a tabic cf function handler entry point 
addresses. These are the entry points for the ' sections of the 
handlers which handle completed I/O events. This table is 
maintained in .TCCC. logical unit number order so that an 
association betw van I/O events and function handlers can be made. 
The IODT is used -by the dispatcher to enter a function handler 
when a completed y./0 event is found. The IODT format is: 

Word 1 /■ c'ldress of I/C completion entry point fcr 

logical unit number 

Rord 2 Address of I/O completion entry point for 

logical unit number 1 

• 

etc. 

Since no BCS standard unit numbers (logical unit numbers through 
6) are used in th ^ system, ircrds 1 through 7 contain the address 
of ,COM, and yio.'.d no effective dispatching. 
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Buffer Manager JBM1 



Functional d escription 

The Buffer Manager is a module which provides a central 
control point for obtaining and releasing buffers by function 
handlers. It manages the centralized buffer storage area cr pool. 
The buffer pool is divided into subpools of two general types. 
Structured subpools are prebuilt with a fixed number of fixed size 
buffers. These subpools are typically used when hardware or other 
system requirements demand a guaranteed number of buffers. A 
single unstructured subpool is also available. From it, buffers 
of varying size can be obtained. All storage not used by program 
modules or fixed data structures is available to this subpool. 
The Buffer Manager has two entry points: .GETB and .FREB. .GETB 
provides a buffer from a subjocl and .FREB allows a handler to 
release a buffer to a subpool. 

When called, the Buffer Manager uses'^the buffer subpocl 
number to map to a Subpool Control List (SCOL) • The SCCI holds 
necessary information about the subpool, such as what buffers are 
free and how many requests fcr these buffers may be outstanding. 
As well as maintaining the buffer subpools a provision is made to 
stack .GETB requests for handlers when .GETB requests fail due to 
buffer unavailable conditions. -A Buffer Pending Request Table 
(BPRT) is associated with each SCOL to record information about 
handlers with buffer pending requests. These requests will be 
eventually satisfied when the buffers become available through 
•FREB. When the buffer manager is entered via .FREB and the SCOL 
for the buffer being returned shows a handler waiting for a 
buffer, that handler will be given the buffer via a .PRIQ. In 
this case BCW word 3 will be cleared and BCW word 2 will be set 
with a command code of 15. (See Buffer Control Words.) 

The BPRT retains information, about handlers which request 
buffers when no buffers are available. Th<* number of slots in the 
BPRT is equal to the number of work queues in the QIT. Each BPRT 
slot then corresponds to a specific work queue. The contents of 
the slct indicate the number cf buffers required by the associated 
work queue. Initially this EPRT has all zero entries. If a 
handler requests a buffer from the associated subpool and none is 
available, the following processing occurs: 

1. The queue name of the caller is used to generate an 
index to the associated BPRT slot. This slot is 
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incremented to shew the requirement of the caller for a 
buffer* 

2. A master count of required buffers in the SCOL (word 
three) is also incremented. If this master count vas 
zerc,. the SCOL fetch pointer is set to address this 
newly incremented BPRT slot. The handler's prime gate 
is close to prevent further processing until the 
requested buffer is available. A "no buffer" return is 
effected. 

When a buffer is returned to the subpool via . FREB, the 
following processing occurs: 

1. If BCW word 1 bit 8 is set, then the buffer is 
interlocked. In this case a true • FREB is cot done. 
Rather, a . PUTQ tc the name in BCW word 3 is done, 

2. If the master count is zero, no further processing 
occurs. 

3. The fetch pointer in the BPRT is used to calculate the 
queue name index. The queue name is then generated, 
and the free buffer is assigned to that queue. The 
count for that queue name is reduced as is the master 
count. 

4. if the master count is now non-zero, the fetch pointer 
is advanced to the next non-zero BPRT slot. This fetch 
pointer is always used in a round robin fashion. That 
is, each BPRT entry will be examined equally often so 
that a handler requesting multiple buffers will not 
receive all of them prior to other handlers. This is 
to prevent lockout conditions by handlers making heavy 
demands of this subpool. 

I&terla.cJ t n£ 

Calling Sequences 

• GETB . - obtain buffer 

Register A must contain the name of the calling 
handler. Register B must contain the desired buffer 
subpool number. The calling sequence is: 
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IDA 


- NAME 


LOB 


PULNO 


JSB 


• GETB 


JMP 


NOBUF 


STB 


BUFAD 



. FREB - free a buffer 

Register A must ccntain the buffer address of the 
buffer to be released. The calling sequence is: 

LDA BUFAD 
JSB .FREB 



Vari ab le length ^uff er sub£g cl 

Requests for buffers frcm sub pool zero are for buffers of 
length supplied by the caller. The calling sequence to .GETB for 
this subpool is modified as fcllcws: 

LDA NAME QUEUE NAME OF CALLER 

LDB LNGTH LENGTH OF REQUIRED BUFFER 

CMB,INB COMPLEMENT LENGTH 

JSB .GETB REQUEST BUFFER 

JMP NOBUF RETURN IF NO BUFFER 

STB BUFAD NORMAL RETURN 

It should be noted that this calling sequence to .GETB differs 
from ether calls to .GETB in its use cf register B. Normally, 
register B supplies the ruirber of the subpool from which the 
allocation is to occur. In this case, register B indicates the 
length of the buffer required. The negating of this length then 
implies use of subpool zero. This is the only subpool for which 
this is true. The length should net include the 9 BCM words. 
These are automatically supplied by the Buffer Manager. 

In order to handle these- requests, the buffer manager will 
use the BPRT for this subpool in a different manner. In the event 
no buffer is available, the requested length will be saved rather 



2-35 



than a count. The nodule MEMRT will be used to perform 
allocations. If the requested length is such that the buffer can 
never be supplied, control vill be returned to the calling handler 
as in a nornal return, and tie B register vill contain the maximum 
size of buffer that can ever be requested. The A register vill 
contain a -1 value. Note that the subpool zero BPRT can only 
retain information about one size of reguest at a time by a given 
handler. If multiple outstatding requests occur, they vill all be 
satisfied vith the last requested size. It is assumed that this 
is the mode of use for this subpool. 

The use of the SCOL fetch pointer vhen a buffer is returned 
to the subpool is as follows: 

1. The buffer is returned using HEMRY. 

2. The BPBT entry addressed by the SCOL fetch pointer is 
used to obtain the length of a buffer required by a 
vaiting handler. 

3. If a buffer of this length is available, it is given to 
the requesting hardier. The fetch pointer is adjusted, 
and processing continues at step 2 for othez possible 
buffer allocation s.^^At the first occurance of non- 
availability, processing ceases. 

If any requests for buffers occur vhen other handlers are 
waiting on the BPRT, those requests are not satisfied (they are 
added to the BPRT). The combination of this technique and the one 
of satisfying BPRT entries it crder guarantees that all requests 
will eventually be satisfied. No lockouts can occur. A master 
count of pending requests is maintained in the SCOL* This is used 
to detect pending requests at the time of new requests. 

For this subpool, BCH vord *» is especially important. It 
holds the length of a buffer allocated from subpool zero. It is 
needed by the Buffer Manager in releasing the buffer to the 
subpool. Therefore, no user of such a buffer may modify BCM vord 
4. 
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S ubp ool c cnt rcl List (SCOL) 

One Subpool Control List is associated with each buffer 
subpool and is used by the Euffer Manager to control buffer 
allocation/deallocation. It is also used in conjunction with its 
associated Buffer Pending Request Table (BPRT) to control delayed 
allocation of buffers when requests cannot be immediately 
satisfied, 

A pointer list to the SCOL's is maintained at locaticn POLPT 
as follows: 

PULPT DEF SGOLO 
DEF SCOL1 



etc. 
Each SCOL has the following format: 

Word 1 * At load time - contains the address cf the 1st 
word of the buffer subpool. At run time 
contains the address of the 1st free buffer (or 
zero if none are available.) 

Word 2 * .At load time - contains the address of the data 
area (1st wcrd after 9 BCW words) of the last 
buffer in the subpool. At run time - contains 
the address cf the last free buffer (or the 
address of this word if none are available) • 

Word 3 Holds a master count of pending buffer requests. 

Word 4 Holds address of naxt BPRT slot containing a 
pending raquest. 

Word 5 Holds the address of the 1st BPRT slot. 

Word 6 Holds ths address of the last word cf the BPRT 
plus one. 

* For subpool zero (variable size buffers) , words 1 and 2 
of the SCCL are initially zero and are not used. 

The term "address of buffer" always means the address of the 
first data word of the buffer. It is assumed that the preceding 
words are the BCW words. BCW word 9 is used by both the Buffer 
Manager and Queue Manager to link buffers together on the free 
list (SCOL) or work queue (QIT entry) respectively. 
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The following subpools are currently in use: 

Variable length buffers 

1 Control buffers (available for general use) 

2 Console message buffers 

(Terminal user buffers are taken permanently from subpool 
zero during system initialization.) 
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BufJ er Pendj.nc} Fe quest Table (BPRT) 

One Buffer Eending Request Table is associated with each 
SCOL. It retains information about outstanding requests for 
buffers. Each slot in the EPRT is one word long and is equated 
with one QIT entry, retaining information about pending buffer 
reguests for that associated QIT name. Hence, the number of slots 
in the BPRT is the same as the number of QIT entrys. The format 
of all BPRT's except the one for subpool zero is as follows: 

Word 1 Number of pending requests for 1st QIT entry 

Word 2 Number of pending requests for 2nd QIT entry 

• 

etc. 

For subpool zero, the BPRT has this format: 

Word 1 Number of required buffers for 1st QIT entry 

Word 2 Size of raquired buffer for 1st QIT entry 

Word .3 Number of required buffers for 2nd QIT entry 

Word 4 Size of required buffet for 2nd QIT entry 



etc. 
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Al loca te/Pea l lccat e Manager (ADM) 

IilIl£tional description 

The Allocate/Deallocate Manager provides a facility tc assign 
and release handlers and gueues for non-shareable resources such 
as line printers, card readers, and paper tape punches. All such 
allocation is done in cooperation with the system processor of the 
HP2000 ACCESS system. This is to prevent uncontrolled 

interference between the TSB and RJE functions. The ADM is also 
used by all handlers to acguire gueue names for appropriate QIT 
entries so that . POTQ's, • .GESQ's, etc., among handlers can be 
done. 

Designators are associated with each of these resources. 
These designators reflect the class or type of device and the 
number of the device (in case more than one is present). The 
designators are formed from a two character class designator and a 
single digit device number. For example: 

LP1 - line printer class - number 1 
CRO - card reader class - number 



A device class and number 
word as follows: 



are represented in one 16 bit computer 



Bit 15 
Bits 14-10 
Bits 9-5 
Bits 4-0 



Zero 

(1st class character) 
(2nd class character) 
(device number) minus 



minus 101 (cctal) 
minus 101 (octal) 
57 (octal) 



To reguest allocation of any device from a given class (no digit 
supplied), bits 15-5 are as abcve, and bits 4-0 are zeros. The 
following designators are currently in use: 



Designator 


Octal value 


Associated gue 


IK0 


(20501) 


Interconnect K 


MX0 


(31341) 


Multiplexor Ha 


TGO 


(46301) 


Time Base Gene 


SCO 


(44 10 1) 


Synchronous Co 


CIO 


(4401) 


Console I/O Ha 


HI0 


(16401) 


Host Inquire C 


HMO 


(16601) 


Hcst Message D 


SI0 


(44401) 


Synchronous In 


HL0 


(16541) 


Hcst List Deco 


HR0 


(17041) 


Hcst Reader Co 


HP0 


(16741) 


Host Punch Dec 


AF0 


(241) 


ASCII Files Ha 



ue and handl 
it Handler 
ndler 

rator Handle 
mmunications 
ndler 

ompression H 
ecompression 
put Queue Ha 
mpression Ha 
repression Ha 
ompression H 
ndler 



er 



Handler 

andler 

Handler 
ndlers (s) 
ndler(s) 
ndler (s) . 
andler (s) 
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LPO 


(26741) 


CRO 


(5041) 


PPO 


(36741) 


PRO 


(37041) 


RPO 


(42741) 



Line Printer Handler (s) 

Card Reader Handler (s) 

Tape Punch Handler (a) 

Phcto-reader Handler (s) 

Reader /Punch/Interpreter Handler (s) 

.gubfloduie func tions 

Three entry points are provided: 

1. .ALL - Allocate a resource 

2. .DEAL - Deallocate or release a resource 

3. •FIND - Request information about a resource 

An allocation request uses the device class supplied by the 
caller to request the use of a device of that class froa the 
system processor* If successful allocation occurs, the SP returns 
the TSB logical unit number cf the device to the Allocate Manager 
which then passes this information on to the requestor as veil as 
the appropriate QIT name* Communication between the SP and the 
Allocate Manager is via an *XOC« call to the interconnect kit* 

A deallocation request uses the QIT name supplied in the 
•DEAL call to release the device* The TSB logical unit number in 
the QIT entry is passed to the SP through an *IOC* call to the 
interconnect kit driver. This shows the deallocation to the SP. 

A .FIND request is used to obtain information about a device 
or class of device* QIT name and/or class information is returned 
to the caller. 

interfacing 

1. .ALL 

Calling Sequence is: 

Device Class desired 

No device available return 
Save logical unit # 
Save QIT name 

• DEAL 

Calling Sequence is: 



LDA 


DEVCL 


JSB 


• ALL 


JHP 


NODEV 


STA 


LOGUN 


STB 


NAME 
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LDA NAME QIT name 
JSB .DEAL 

3. .FIND 

Calling Sequences are: 



LDB 


LOG UN 


JSB 


.FIND 


JMP 


NODEV 


STA 


DEVCL 


STB 


NAME 




or 


LDA 


DEVCL 


CLB 




JSB 


.FIND 


STA 


LOGUNI 


STB 


NAME 



Zero A-Reg 
Logical unit # 

Nc device by that # 
Save device class 
Save QIT name 



Device class S number 
Clear B-Reg 

Nc such device 
Save QIT name 

NOTE: The two .FIND calling sequences are required to 
extract information by supplying either logical unit 
number or device class and number. 

The Allocate/Deallocate Manager depends upon the second 
segment of the QIT being ordered by TSB logical unit number for 
all non-shareable devices. 

The manager forms an IOC call to the ICK driver of the 
following form for Allocation 

Store device class 

Write control 



STA 


DEVCL 


JSB 


.IOC. 


OCT 


220XX 


JMP 


NODEV 


DEF 


PARM 


DEC 


2 



* THE ALLOCATED TSB LOGICAL UNIT NUMBER WILL 

* REPLACE DEVCL 



PARM OCT 160006 
DEVCL BSS 1 

For Deallocation the IOC call is 
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LDA 


LOGUN 




ALF, 


ALF 




BAR 






IOR 


ROR 




STA 


PARND 




JSB 


.IOC. 




OCT 


220XX 




HLT 


OB 


(car. net 


DEF 


PAR HO 




DEC 

• 


1 




• 
PARMD BSS 


1 




RDR OCT 


160007 





happen) 
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Dev ice As signment Manager (DAM) 



The Device As 
establishing and act 
handlers obtain per 
information to do so 
information is con 
vhich is created at 
STRUCTURES) • The 
contents of the DAT 
of the Device Assign 

Submodula f unct 3.0n s , 



Functi cnal descri 
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mission to activate linkages an 
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as directed by the system opera 
ment (DA) command. 



e mechanism for 
rs. Requesting 
d the necessary 
The required 
ent Table (DAT) 
ee LCCAL DATA 
r modifying the 
tor through use 



Three entry points tc the Device Assignment Manager are 
provided: 

1. .DA - processes Device Assignment commands, 

2. .BSY - processes reguests to activate linkages between 

handlers. 

3. . UBSY - processes directives tc deactivate linkages 

between handlers. 

A device assignment request (.DA) uses the parameters input 
with the DA command tc ncdify the contents of the Device 
Assignment Table. If the host function specified is not currently 
active, the DAT entry for that function is updated to reflect the 
new assignment and a skip return is made to the caller. If the 
host function is busy, the entry is not altered and a reject 
return is made to the caller. 
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quest (.BSY) uses the device name l of 
be linkage can be established. This 
first obtaining the device name of the 
1. If the assigned device is a real 
line printer, etc) , then the manager 

device. If the allocation is 
rn is made to the .BSY caller. If the 

QIT name and logical unit number of 
eturned to the .BSY caller. For other 
fcr other assignments of the same 
r if existing ones are marked as not 
to obtain the Qname and logical unit 
evice which is returned to the .BSY 
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caller. Otherwise a reject return is made to the caller* Before 
making a successful return the caller's entry in the DAT is Barked 
active* 

A deactivate call (.OB ST) uses the device name of the caller 
to locate the appropriate DAI entry and mark it as not active* If 
the assigned device is real, a deallocate call is made before 
returning to the requestor. 

1* .DA 

Calling sequence is: 

LDA DNAHE Host function name 

LDB HNAME Device name to be assigned 

JSB .DA 

JHP NANS6 command net appropriate return' 



2. *BSY 

Calling sequence is: 

LDA DNAHE caller's device name 

JSB .BST 

JMP PJCT reject return 

STA IOGOH save assigned LU # 

STB CHAME save assigned Q name 

3* .OBST 

Calling sequence is: 

LDA DNAME caller's device name 
JSB .UBST 



Note: Reject returns from .EST and .OBST will affect the extend 
(E) register as follows: 

E=1 - call was for a pseudo device 
. E=0 - call was for a real device 
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The Device Assignment Manger issues calls to the allocation/ 
deallocation manger as follows: 

For allocation: 

LDA ANAME assigned device name 

JSB . ALL 

JMP N0DEV device not available return 

STA LOGUN save logical unit # 

STB QNAME save Qname 

For deallocation: 

LDA LCGUN logical unit numbar 

JSB . DEAL 



For obtaining qname and LU# : 

LDA A NAME assigned device's name 

JSB . FIND 

JMP NCDEV no device return 

STA L0GUN save LU# 

STB QNAME save qname 

Lp.£ill Dgtg Structures 

Device Assignment Table (DAT) 

The Device Assignment .Table contains one 2-word entry for 
each "Host function" defined at system configuration time* The 
allowable host function are: 

1. HR1 through HR7 for host reading functions* 

2. HL1 through HL7 for host line printing functions 

3. HP1 through HP7 for hcst punching functions. 

The DAT is prefixed by cne word, which is a pointer to the 
second. 

Each entry is definded as fellows: 

SORD1 BITS- 0-15 host fur.cticn name* 
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W0HD2 BIT 15 -=1 if function is active 
=0 if function not active 
BITS 0-14 - assigned device name 1 

The last two words of DAT ar€ -1, 

CRn ■- card reader n 

LPn - line printer n 

JTn - job transmitter n 

JLn - job line printer cutput n 

JPn - job punch output n 



* the function and device naies are encoded as follows: 

BITS 14-10 1st character cf device name 

minus 101 octal 
BITS 9-5 2nd character of device name 

minus 101 octal 
BITS 4-0 device number minus 57 octal 
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Sistsj Startup Ro utin e 



F un ctional d es cri-^o fr 

This routine is the starting point for the IOP software. It 
also contains an utry point fcr systea restart and a panic 
routine. The purpose of SYSTR is to dispatch all handlers 
during system stn.cup or. restart and then to start the dispatcher,, 
SYSTR 's panic r. atine provides normal responses to the SP in the 
avent of an IOP •'■-.{.lure* 

The only v. .Cference between the START and RSTRT routines is 
the setting of !•, .\-.tion STATE. The routine START sets STATE=0 and 
RSTRT sets it ;;o 1. Subsequent processing is the same in both 
cases and con.-rl; °;s of searching through QIT for handler 
initialization oa::cies. Each handler is called by: 



LDA 
JSB 



;tate 
•atry,! 



After all entricu are coripleted the routines exit by a 

J MP ..co a. 

PANIC simply provides tie necessary responses to the SP so it 
may be SLEPT in case of an ICP failure. 

Calling sequances: 

At system startup tine SYSTR is entered at location START. 
Entry is made by setting the START address in the P-reg and 
pushing .RUN. This routine exits via a JHP .COM. 

At system restart time SYSTR is entered at location RSTRT by 
a JMP RSTRT. Exit is through a J HP .COM. 

The entry point PANIC provides for automatic responses to the 

SP in the event of an IOP crash. The routine is started by 

entering the PANIC address in the P-reg and pushing START. It 
will continue to run until HALT is pushed. 

Called routines: 
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During the. startup and restart processing, SYSTR calls all 
device handlers. Control is passed by a JSB to the indicated 
address with A reg=0 on a system startup and A reg^O on a restart* 

LocaJL data structure s . 

None (see QIT in Global data structures). 
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Cen t ralize d consol s output 

D esc rip tio n and fu ncti on 

This system service routine (.v-JO. ) performs the task of 
transferring a message to the console output queue. Any handler 
may contain a group of ccnsole messages. The handler can then 
mark a message for output and call the centralized console output 
routine. This routine will acquire a console buffer, locate the 
marked message, move the message to the console buffer, remove the 
mark from the message, and place the console buffer on the console 
output vork gueue. In the event that no console buffer is 
available, the routine leaves the message marked and returns to 
the calling handler. In this case, the calling handler will 
eventually receive a conscle buffer on its work queue. This 
buffer can be provided to the centralized console output routine 
to finally dispose of the marked message. 



Handlers using this centralized console output routine must 
construct their message lists similar to the following eiaiple: 

HSGO ABS MSG1-MSG0-2 

OCT X 

ASC n, message text 

HSG1 ABS HSG2-MSG1-2 

OCT x 

ASC n, message 1 text 
HSG2 



HSGL OCT 

The first word of each individual message contains the length (in 
words) of the message text. This value must be positive. The 
word following the last message must be zero. The second word is 
used to construct BCW word 8 in the console buffer for the 
message. In this way a handler can present special flags in BCW 
word 8 to the conscle output module. Bits 3-0 of BCW word 2 will 
be set to the value of 1 . 

A handler marks a message by setting bit 15 of the length 
word. 

Calling sequences are: 

1. If no console buffer is supplied: 
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CLA 




LDB 


QN 


JSB 


.ceo. 


DEP 


MSGO 


J HP 


X 



(indicates no buffer) 

(calling handler's queue name) 

(address of 1st aessage in a list) 
(return if no console buffer available) 
. .. (normal return) 

2. If a console buffer is supplied: 

LDA BA (address of supplied buffer) 

JSB .CCO* 

DBF MSGO (address cf 1st message in a list) 

MOP (always a skip return) 

. CCO, nay be unable to dispose of a aessage because of 
unavailability of console buffers* This is ususally nc problea 
since a buffer vill later be aade available to the handler that 
invoked .CCO. However, one problea does exist. A handler aay be 
required to issue a aessage again, and it aay still be marked froa 
some previous call to .CCO. The handler has two options, it aay 
ignore this problem, in vhich case the duplicate aessages are 
lost.' A second option is to temporarily suspend processing if the 
message is already marked. In this latter case, a console buffer 
will eventually become available to relieve the handler of the 
message. Then the message can be remarked and reissued. 
Obviously, the second option is the better choice when aessage 
content may change or when the number of responses should equal 
the number of events which elicit responses. 

On entry to this routine, three parameters are provided. The 
first is the address of a grcup of one or more console messages. 
Thd second is the address of a console buffer if one can be 
supplied or a zero to indicate that no console buffer is being 
supplied. Parameter three is the naae of the calling handlers 
work queue. 

If no console buffer is supplied, a .GETB is issued to obtain 
one using the calling handler's work queue name. If this attempt 
is unsuccessful, the routine returns to the caller. 

Next the list of aessages is searched for a marked message. 
If none is found, the console buffer is returned via . PREB, and a 
return to the calling handler is made. If a marked message is 
located, the mark is removed, and the aessage is transferred to 
the console buffer (i.e. the one just acquired or the one provided 
as a parameter). 
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Finally, the console buffer is placed on the conscle output 
queue. A return to the calling handler is Bade. 



Data conv ersion aids 

Several general purpose system services have been designed 
which aid in data conversion. Since the RJE function is based on 
the EBCDIC code, such conversion between ASCII and EBCDIC takes 
place. There are also requirements for conversion between binary 
integer values and their printable ASCII counterparts* These 
conversions are handled by the following routines: 



•ATOE - 



.ETOA - 



.BTD. 



• DTB. - 



converts a string of ASCII characters to EBCDIC. The 
conversion is done in place. The B register provides 
the address of the string, and the A register provides 
the length. 

converts a strizg of EBCDIC characters to ASCII* The 
conversion is done in place. The B register provides 
the address of the string, and the A register provides 
the length* 

converts an integer value to a string of characters 
consisting of one space and five decimal numerics* If 
the integer is negative, the space is replaced by a 
minus sign. The A register provides the integer value, 
and the B register provides the byte address of a six 
byte area to receive the string. 
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All of the above routines are used as follows, where M na«e" is one 
of the four routine names: 

EXT name 

• 

LDA (A ragister parameter) 

LOB (B register parameter) 

JSB name . 

Only the #DTB. routine has as alternate return. 
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.DCQM - dec ompression servic e 

£escr.i£tio|i ajjd | u notio n 

. DCOH provides a data decompression service to expand IBM 
aultileaving compressed records into uncompressed format for unit- 
record devices. It is typically called by output decompression 
handlers and is thought to be an RJE related module. 

Interfacing, 

The routine is entered via a JSB vith calling parameters in 
registers and following the call. It will return two values in 
registers. The calling sequence is: 

LDA <from addr> 

LDB <to addr> 

JSB .DCON 

DEC < buffer length> 

<from addr> is the byte address of the data to be 

decompressed. This must be the address of the 

first SCB ir the data. 
<to addr> is the byte address of the destination of the 

decompressed data. 
<buffer length> is the positive byte length of the buffer to 

receive the decompressed record. 

Upon return the registers will contain the following: 

A-register: Length of decompressed record (# if EOF record) • 

B-register: Pointer to next BCB in source buffer. 

Note: If there. is more data in the compressed record than is 
available in the buffer, excess data will be truncated. The 
length returned will never be greater than <buffer length>. 
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Miscellaneous systea service routine s 

The following service routines are available 
for use by any nodules: 



^cqq p - compression service 



Qescr^pt^ qn an.d function, 

• COMP provides a data compression service to compact records 
according to the IBM multileaving format. It is typically called 
by input coapression handlers and is thought to be an RJE related 
aodule. 

Interfacing, 

The routine is entered via a JSB with the parameters in 
registers and following the call. It returns a value in a 
register. The calling seguence is as follows: 

LDA <from addr> 

LCB <from length> 

JSB .COMP 

DEF <to addr> 

<froa addr> is the byte address of the data to be compressed. 

<froa length> is the number of bytes of data in the block to 
be compressed. 

<to addr> is the byte address of the destination of the 
compressed data. The RCB and SRCB are not 
supplied by .COMP'. The caller is assumed to have 
already inserted these characters* This address 
must point to the location where the first SCB is 
to go. 

Upon return, the B-r agister will contain the byte address of 
the next location in the- destination buffer following the 
compressed data. 



2-55 



£iZl£is l2.ble 

The Device Table is constructed by the I/O Configurator 
Program to provide information about non-shareable devices 
supported by the total system. The format of the table is as 
follows: 

.DVTB DEF *+1 

DEC n Contains * of supported TSE ports 
DEC m Contains # of following entries 
OCT a r b,c r d,e Five word entry for 1st device 
OCT f#g#h,i,j Five word entry for. 2nd device 



etc, 

A total of "in" five word device entries will exist. The format 
for each is as follows: 

Word 1 Device designate;: or name 

(Refer to Allocat /Deallocate Manager) 

Word 2 Device select ccu r . in bits 5-0 

Eit 15 is a one iv: the device is 
capable of input <\nd bit 14 is 
one if the device is capable of 
output. Eit 12 i.; set if the only 
output allowed i.-. CTL, 

Word 3 Maximum record si • -..a for device 

Word u Zero 

Word 5 Zero 

A TSB logical unit number is associated with •: r»ch device. Device 
Table entry number corresponds tc TSD logical unit number and so 
forth. 
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I. Introduction 

H±QH Pp.*5IE Fai l/Rest art Mod ule 

This module will store the state of the system in the I/O 
Processor (IOP) at power failure time. At power recovery time, 
working closely with all I/O drivers and cooperating with the 
System Processor (SP) , the saved information will be used to 
restore the software to its operating state. It is a basic design 
point of this module that sufficient recovery information is 
maintained to "insure th€ completion of all scheduled I/O 
operations, However, due to the impact of power loss at the 
actual I/O devices, some I/C operations will necessarily complete 
in error or with data loss. This is a point to be addressed by 
the individual I/O drivers. 

II. Design Overview 

Two primary processing sections make up D.04. Both are 
triggered by an interrupt through interrupt vector 4. The 
direction of the interrupt (power failure cr power restart) is 
inspected in order to dispatch the appropriate processing section. 
Power failure processing saves register contents, I/C device 
states, and DMA processing states and then halts the CPU. (This 
routine does take into account the possibility of a power failure 
during some previous power recovery operation. ) 

Power recovery processing includes a cooperative restoration 
of interconnect kit states with the System Processor. Then device 
states are restored, and - I/O driver power fail appendages are 
given control to correctly restore their states relative to their 
respective devices. Finally, registers and interrupt system 
states are restored, and the operating system regains control. 

III. Design Structures 

JiSl&li: 2D§kiE 2l ULlQI 12 the System Processo r 

Proper restoration of the system following a power failure 
requires close cooperation with the System Processor. 

Specifically, the correct operational state of the interconnect 
kit must be maintained, since it is more properly viewed as an 
extension of each central processing unit than as a peripheral. 
An auxiliary cable between the two CPtMs ensures that each will 
receive the power loss signal at the same point in time* . This 
technique constrains their power failure interrupts to occur iro 

2-58 



2-59 



more than one instruction apart and insures that the state of the 
interconnect kit device flags can be. saved. However , the status 
of any DMA transfer ever the interconnect kit Bust be 
reconstructed. (DMA is inhibited by a power failure interrupt.) 
Also, power failures occurring during previous power recovery 
attempts must te carefully ncted, so as to prevent improper 
changes in the recorded systam state. Obviously, D.OU processing 
related to the System Processor is very dependent on the D.61 
Interconnect Kit I/O driver. Much of what is stated here is 
further documented in the D.61 Base Design Specifications. 

Each processor must maintain six words of information. One 
of these, POWFF, is a flag local to the power-f ail/power-up 
routines. It is used to assist in identification cf power 
failures occurring during recovery from a preceding one. RCHNO 
and SCHNO contain the last words sent (exclusive of a DMA 
transfer) on the interconnect receive and send channels 
respectively. These are obviously needed to restore the state of 
the interconnect. DMAFL is a state variable containing the DMA- 
on-interconnect status of the processor program. It is used to 
determine if the power failure disrupted a DMA transfer. The 
final two words record the length, starting memory address, and 
direction bit cf the most recent DMA transfer on the interconnect. 
Thair existence allows ths recovery routine to restart an aborted 
transfer. 

Since the order in which the pre ^ssors will complete their 
recovery routines cannot be predicted, ^o sequencing requirements 
must be observed. First, each word placed on the interconnect is 
to be recorded in either BCHNO or SCHNO as appropriate before 
issuance of the 'STC sc,C' which signals its presence to the other 
processor. Second, neither processor can proceed to its 
interconnect DMA routine until after execution of the last 
instruction affecting the system processor's send flag and I/O 
processor's receive flag, regardless of which processor will 
execute the instruction (i.e., cne processor? may have to wait for 
its flag to be set by the ether processor) • This condition is 
automatically net by the handshake requirements of POS, A1E # and 
RJE. It is also a fallout of the design for SCI, TCM, and the 
requests for the device table (SET) or cold dump core image (KSN) . 
However, use cf XRB requires that the I/o processor wait for its 
receive flag to become set, after transmitting the transfer length 
word, before invoking its interconnect DMA routine. (Note:* POS, 
ALB, etc. are. all mnemonics for commands processed by D.61 in 
conjunction with the System Erocessor.) 
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Special microprogramming for power fail/restart 

Three special microprograms will' be written to aid I/O 

drivers in power recovery processing. There are two basic 

questions which an I/O driver will need to answer in determining 
correct power recovery action: 

1) Has a specific I/C instruction been executed? 

2) Is an interrupt section engaged in processing an 
interrupt at the tiae of a power failure? 

The first question can indicate whether an interrupt was 
being anticipated at the tiae of a failure or whether specific I/O 
interface conditions had been established. The best way to answer 
this question is to set a software flag which marks the fact that 
an associated I/O instruction has occurred. However, using the 
basic instruction set, a pouer failure could occur between the 
I/O instruction and the instruction which sets the software flag* 
This would result in an inability to answer question one easily. 
For this reason, a microprogram will exist that will incorporate 
the execution of the I/O instruction with the setting of the 
software flag. Its calling sequence will be as follows: 

PFRIO EQO 221 E 

. 

RAM PFRIO 
IC STC sc,C 
FLAG OCT 

10 can be any I/O instruction which does not involve k or B. FLAG 
will be set to 1 by PFRIO. It is assumed that FLAG will be 
cleared by an interrupt handler or other point where the effect of 
the I/O instruction has been noted. 

The second question nust be answered in order to determine 
the proper action to occur relative to a pending or existing 
interrupt condition. Through the use of two special 
microprograms, the value of the interrupt entry point can be used 
to ascertain the activity of a driver 1 s continuator segment. For 
purposes of discussion, let I. XX denote an entry point for a 
driver continuator section. An interrupt typically invokes a JSB 
to I. XX. Hence if I. XX is assembled as zero, the interrupt will 
force I. XX ncn-zero. Thus, a test of I. XX can indicate activity 
of the segment. The only resaining problem is to incorporate a 
clearing of I. XX when exiting through I. XX. The two microprograms 
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perform this function. One, in addition, incorporates the PFRIO 
microprogram noted above. Calling sequences are: 

PFREX EQU 223E 



RAM PfREX 
DEF I. XX 



PFREI EQU 222E 



RAM PFREI 
IC STC SC,C 
FLAG OCT 

DEF I. XX • 

In both cases, control will be transferred to the location whose 
address is found in I. XX (as in a JMP I. XX, I). Also, I. XX. will be 
set tc zero. 

IZ2 illij£§£ £2E jideratigns 

During pcwer recovery processing, each I/O driver must be 
given an opportunity to ncte the failure and take possible 
corrective action. D.04 assumes that each I/O driver contains a 
subroutine entry point, P. XX, in addition to its D.XX and I. XX 
entry points (that is, its initiator and continuator entry 
points). After restoring th€ state cf the interconnect kit, D.04 
will enter each of the P. XX subroutines. It is assumed that P. XX 
will dc some or all of the fcllcwing things: 

1. Since it is possible for power to fail during a power 
recovery operation, P. XX may not be able to" complete. 
In addition, should this occur, P. XX will be restarted 
not continued. Fcr this reason, P. XX must not alter 
any data or variables which it needs to perform its 
work. 

2. I/O interface ccrtrcl word registers may need to be 
restored. An exanple would be the speed and other 
parameters for the ports on the asynchronous 
multiplexer interface. 

3. Power fail or other status may need to be recorded in 
the EQT status word. (This is only necessary if needed 
by other portions cf the driver or as a part of status 
returned in IOC calls.) 
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4. Due to the fact that the correct nesting of active 
interrupt sections (continuators) must be restored at 
power recovery tine, D.04 requires that no ccntinuator 
allow itself to be interrupted by lower priority 
continuators. * 



5. When power is restored to the system, all devices flags 
are set and all ccntrol flip/flops are clear. That is, 
an interrupt is pending* In addition, the state of 
device flags at pcwer failure tiae will be saved. Each 
P. XX appendage Bust restore its driver relative to 
these flags: 



State of I/O 
driver interrupt 
section 



State of 
saved flag 



Action 

to be performed 



Idle 



Clear 



Idle 



Set 



Active 



Clear 



Active 



Set 



Clear device flag if 
appropriate* Reissue any 
I/O instructions which 
aay have been lost (see 
PFRIO microprogram) • 

If an interrupt is 
pending, issue an STC 
instruction to allow it* 
Otherwise, clear the 
flag. Reissue any lost 
I/O instructions. 

Allow an interrupt to 
occur in order to restore 
the proper nesting of 
interrupts (see D.04? 
below) • Then clear the 
device flag. Reissue any 
lost I/O instructions. 

Allow an interrupt to 
occur. Reissue any lost 
I/O instructions. 



As noted above, in the discussions of the PFREX and 
PFREI microprograms, the activity of an interrupt 
section can be determined from the value of its entry 
point. Testing the saved state of the device flag and 
allowing an interrupt for proper interrupt nesting are 
two functions provided by D.04. A subroutine called 
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D.0<4? may be called by any P. XX appendage with the 
select code of a device in register A. D.04? always 
returns a non-zero A if the saved state of the device 
flag is set and a zero A otherwise. In addition, if 
register B is set to a - 1 value, D.OU? will allow an 
interrupt on the select code in order to restore its 
nested interrupt condition, 

P2Ji££ dow n processing sectioc 

The power-down routine distinguishes between four possible 
cases* 1) If power fails during normal time-sharing, PCWFF = 
and the restart address is not within the recovery procedure. 
Hardware registers are saved (A, B, P, 5, R, 0, and F) • The 
states of the interrupt system and all device flags are saved. 2) 
If power fails while the SP is not time-sharing (during system 
shutdown, system loading, cr after the SP has completed shutdown 
or failed), the SP will not save its state or attempt to recover. 
Ihe I/O processor (IOP) , however, is normally still active 
(waiting for the SE to signal resumption of system activity) and 
does not distinguish this case frcm the preceding one. 3) POWFF 
» 1 identifies a power failure from the recovery routine prior to 
restoration of the interconnect. Sine? no system activity has 
occurred on either processor as yet, their current states are 
ignored and recovery begins anew frcm the information recorded at 
the initial failure. 4) If EOWFF = 2 or the restart address lies 
within the recovery routire, then the interconnect was restored 
but the processor had not yet completed the remainder of its 
recovery. This differs from case 3 in that the other processor 
might have completed its recovery and returned tc its pre-failure 
activity. Having done so, it might further have eiecuted an 
instruction which legitimately altered the state of the 
interconnect. Each processor is responsible for correctly 

restoring its send channel (simultaneously restoring the other 
processor's receive chanrel) . Thus the processor in this 
situation need only determine if its send channel flag is now set 
(it could not have been cleared by the other processor) and, if 
so, overlay the previously recorded state. 

The state variable DMAFL allows detection of aborted DMA 
transfers on the interconnect. It must be set to zero whenever 
time-sharing begins in order to synchronize the processor states. 
Each entry to the intercornect DMA routine first saves the 
transfer parameters and then increments DMAFL to the next odd 
value. When the processors hardware DMA flag comes set, it 
increments its DMAFL to the next even value, executing net less 
than three instructions to ensure that the other processor has 
time to complete its current instruction, possibly steal one cycle 
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for DMA channel 6, and then perform the last cycle for DHA channel 
7. (All interconnect DHA activity occurs on channel 7.) Note that 
this is only a convention based on the assumption that DHA channel 
6 can not steal ail cycles. If channel 6 did steal all cycles 
then the required three instruction sequence vould fail to insure 
that the other processor had in fact completed its DMA transfer. 
(No procedure can guarantee completion if DMA channel 6 performs 
in this manner.) I£ the last two bits of both processor's stats 
variables are even (00 vs. 00 or 10 vs. 10) then no transfer is 
active. DMAFL will be odd (01 or 11) while a processor is in the 
critical portion of its transfer routine. The other processor's 
DMAFL will be one less (00 vs. 01 or 10 vs. 11) if it has not 
reached its transfer routine, or will be equal (01 vs. C1 or 11 
vs. 11) if also in its transfer routine, or will be one more (10 
vs. 01 or 00 vs. 11) if the transfer completed. The remaining 
combinations (00 vs. 10 cr 01 vs. 11) cannot occur since the 
processors can never be more than one state apart. This assumes 
that both processors reset DMAFL to zero at system initialization 
time. 

Possible IMAFL Combinations 



Neither processor in its transfer routine. 

IOP doing transfer, SP not yet to its transfer routine.* 

SP doing transfer, IOP not y9t to its transfer routine.* 

Both SP and IOP is their transfer routines.* 

SP in its transfer routine but transfer is ccsplete. 

IOP in its transfer routine but transfer is complete. 

Neither processor in its transfer routine. 

IOP doing transfer, SP not yet to its transfer routine.* 

SP doing transfer, IOP not yet to its transfer routine.* 

Both SP and IOP it their transfer routines.* 

SP in its transfer routine but transfer is complete. 

IOP in its transfer routine but transfer is ccmplete. 

* Transfer will be restarted. The SP must set its send channel 
flag/IOP's receive channel flag according to the transfer 
.direction. 

Impossible DMAFL Ccmbinations 
SP: 00 01 10 11 
ICP: 10 11 00 01 

£°.££.£ secgvery processing section 
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The IOP power-up recovery routine is straightforward except 
for restoration of the interconnect. It begins by setting POWFF 
to 1 .and then re-enabling -power-fail interrnpts. The WCS module 
is restored. Then the P. 61 interconnect kit driver power recovery 
appendage is entered. P. 61 perforins as follows: since recovery 
requires an exchange of information, the IOP must clear its 
receive channel flag and then wait enough time for the SP to 
complete its power-down routine, clear its receive channel flag, 
snd transmit its data. The IOP routine does this by incorporating 
a timing factor into its wait loop. If the loop times out, then 
the SP must not be active and the IOP should restore itself to the 
same state as it would be in following reception of- an SSD from 
the SP. After clearing' its receive channel flag, the SP will send 
a word containing zero bits except for the direction bit of the 
last DMA transfer (1 if frcm the IOP, if from the SP) in bit 
and the last two bits of its DMAFL in bits 2 and 1. The recovery 
routines are now in synchronization". The IOP responds with its 
most recent DMA direction bit (C if frcm the IOP, 1 if from the 
SP.) and the low two bits of its DMAFL in the same format. 

At this point both processors have a complete' record of the 
interconnects state at power-fail. The IOP automatically places 
th-a current value of BCHNO en its receive channel and sends it to 
the SP. If the IOP*s DMAFL is odd and the SP's information 
indicates that the transfer did not complete, the IOP makes a note 
to reinitialize its DMA routine later in the recovery process. 
The IOP now waits for the £P to set the IOP's send channel flag. 
When this occurs, the IOP examines its record of the flag at the 
time when power failed. If it was clear, the IOP restores the 
word from SCHNC and issues the »STC n,C'to transmit it. Finally, 
POiFF is incremented to 2 sir.ee the interconnect is now completely 
restored (the SP will not finish its recovery until well after the 
IOP finishes all of the above). The remainder of the ICP routine 
consists of ensuring that an aborted DMA transfer en the 
interconnect will be restarted, performing the out-of-line device 
recovery routines, resetting POWFF to after returning to the 
power-up routine, restoring the hardware registers and interrupt 
system flag, and resuming tioe-sharing. 
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I. Introduction 

The D. 43 driver provides timer facilities for both I/O drivers and 
the user level program. ; v 

D. 43 is a somewhat unusual driver in that it »ay be called 
directly by other drivers as well as by standard •IOC. calls from 
a user program. For convenience, driver calls will be designated 
as Line Timer Bequests and .IOC* calls as System Timer Bequests; 
The following functions are available from this driver: 

v 

1. "Start"" - Enables clock interrupts. Hust be executed at 

system startup to enable timing facilities. 

2. "Set Timer" - Reguest by caller to be notified after 

specified time interval expires. 

3. "Cancel Timer" - Cancel previous timing request. Beturns 

residual time interval. 

II. ^Design Overview 

2§.§ik2U s umm ary 

The driver is a module of the IOP software for the HP2000 ACCESS 
system. The driver will provide .1 second timing resolution for 
requests. Hardware requirements are a 2100 computer and time base 
generator 12539A. The HP200C ACCESS I/O processor aicroccde is 
required. 

III. Design Structures 

fii.il structures 

The term TQE is used to refer to a Ti mer Quou.e, Ele ae n^ . The 
address of an area to be used as a TQE must be passed to the 
driver as a parameter in all calls. The form of a TQE is shown 
below. (Only the first two words must be preset by the caller. 
These words are not disturbed by 0.43.) 

12.5 for Line Timer Be ques t 

LTQE DEC ; Number of . 1 second ticks to time 
DEF Exit address upon timer completion 
BSS 1 Flag/link word used by driver 

Bit 15 «o - system tiaer request 
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=1 - line timer request 
Bits 14-0 link address 
BSS 1 Expiration clock value for TQE 

2£I £°£ S-2§liS liSlil Rgflugst 

STQE DEC Number of .1 second ticks to time 
DBF Exit address for timer completion 
BSS 1 . Flag/link word used by driver 

Bit 15 =0 - system timer request 

=1 - line timer request 
Bits 1U-0 link address 
BSS 1 Expiration clock value for TQE 

£§Jl2I functional m odul es 

Start 

Ihe start request puts the Time Base Generator "on line" and 
enables all timing requests and must be executed by the user 
program to enable all timing functions. 

The start algorithm is outlined below: 

1. Enable I/O board interrcpts. 

2. Return. 

The calling sequence is as fellows: 

JSB .IOC. 

OCT XX where XX is logical unit number. 

Set Timer 

The set timer request enables timing to cause asynchroncus return 
after caller specified time interval. The execution sequence for 
this routine fellows: 

1. Insert request in timer queue. 

2. Return 

The calling sequence for this routine is as follows: 
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1. Line Timer Request 

ATQE DEF TQE 

LDA ATQE address of TQE to "A" 
JSB . LTS. Bequest Line Timer Set 

2. System Timer Request 

JSB .IOC, 

OCT 2J0J3XX where XI is logical unit number 

JMP REJCT 

DEF STQE Address of TQE 

BSS 1 

When the time interval expires for a line timer request, the 
address of the TQE is placed in register B, and a JSB to the exit 
routine specified in the TQE is made. The system is disabled 
during this exit. For systei timer requests, the address of the 
expired TQE is returned through .IOC. as an unsolicited event. 

The cancel timer request is used to cancel a previous timing 
request. The driver will return the number of ticks remaining to 
expiration in word four cf the TQE. The execution alogrithm 
follows: 

1. Search timer queue f cr specified TQE. If not found, take 
reject address. 

2. Remove TQE from queue, and store residual tick count in TQE 
word 4. Mote that normal TQE expiration results in a zero 
word 4. 

3. Return. 

The calling sequences for this routine are as shown belcw. 

1. Line Timer Requests 

LDA ATQE Load A with address of TQE 
JSB .LTC. Request cancel 
JMP ERROR Reject address 
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2. System Timer Requests 

JSB .IOC. IOC call 

DEF ippXX Request cancel 

JMP REJ Reject address 

DEF STQE TQE address 

BSS 1 . 

A reject indicates the specified TQE was not in the tiaer queue. 
This may indicate the timer has already expired before the call 
was made to cancel it. 

£°.Ji§£ £££2I££i app enda ge 

The P. 43 appendage receives control from D.04 at power 
recovery time. The time base generator decade value is reset. If 
the 1.43 interrupt handler was active, then D.04? is invoked to 
restore the interrupt condition of the interface. Otherwise, an 
STC is issued to reactivate the timer. 
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T4 ffl g Sase Genera tor Handler 



functional £es< 



This handler (TBGH) pro 
D. 43 tine base generator dri 
handler since it does not c 
the nediun of work queues an 
services are utilized thro 
drive the time base generato 
con pie ted event notification 
also through JSB calls, 
nodules the ability to: 



vides systen tiner service through the 
ter. In one sense TBGH is not a true 
cnnunicate with other handlers through 
d the queue manager. Instead its 
ugh JSB calls. TBGH does use .IOC. to 
r and is dispatched by DSPCH upon 
s. It passes control to other nodules 
Specifically, TBGH provides calling 



1. 



set a tiner 



2. cancel a tiner 

3. provide_a routine to be called when a tiner expires 

During systen initialization TBGH is entered at location 
IBGHI. A START call to the TBG driver is issued and th€ routine 
exits. 

For tiner requests TEGH is entered at entry point TBGHQ. 
Processing consists of a SET TIMER request to the TBG driver using 
the TQE provided by the caller and exit to the caller. 

For purging of tiner requests the entry point is TBGHP. 
Processing consists of a CANCEL TIBER request to the TBG driver 
with the TQE pointer provided and an exit to the caller. 

Expired tiner request processing occurs at entry point TBGHC. 
Word 2 of the expired TQE contains the address of a processing 
routine. It is entered via a JSB call, return is to the location 
following the JSB. Exit is to the dispatcher. 

Ifttgf facing 

calling sequences: 

TBGH is entered at lecation TBGHC whene ;.jr a tiner request 
expires. The calling sequence is: 
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LDA parami copy cf IOC parameter word 
LCB param2 address cf TQE 
J MP TBGHC 

The exit procedure is: 

JMP .COM. 

To queue a timer reqcest TEGH is entered at location TBGHQ 



by; 



LDA parami address of TQE 
JSB TBGHQ 



The routine exits by: 

JMP TBGHQ,! 

To purge an outstanding timer request TBGH is entered at 
location TBGHP by: 

LDA parami address of TQE 
JSB TBGHP 

The exiting procedure is: 

JMP TBGHP, I if th€ TQE cannot be located 

or 

ISZ TBGHP if th€ TQE is purged 
JMP TBGHP, I 

TBGH is given control during system initialization at 
location TBGHI by a 

JSB TBGHI 

control is returned through a 

JMP TBGHI, I 

called routines: 

TBGH makes requests cf the time base generator through 
standard .IOC. calls. Tiaer completion notifications are 
processed by a caller provided routine. The routine is accessed 

by: 
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RAM LAH-TQEW2 address of service routine to reg A 
JSB A # I call routine (reg B contains TQE addr) 

JMP .COB* exit after return 

ioc.a.1 data strjjc£t|res 

Every timer -request is communicated to SBGH through a Timer 
Queue Element (TQE). The TQE is 4 words long and is defined as 
follows: 

WORD 1 

15 

timer interval 

number of • 1 second ticks in requested interval. 

WORD 2 

15 • 

process pointer 

address of a routine to be given control at time interval 
expiration 

WORD 3 

.15 =0 - system timer request 

*1 - line timer request 

14-0 lirk word 

WORD 4 

15 clock expiration value 

two system link words to be used by the device driver. 
Following any cancel or expiration, the fourth TQE. word 
contains the number cf ticks remaining (0 in the latter 
case) • This is referred to as the interval residual. 
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I* Product Identification 

Micr op r ogr am components £or HP2Q 00 ACCESS 1^0 pr oce ssor 

Microprogramming will make a significant contribution to the 
project. Of primary concern is efficiency. Microprograms are 
being designed and implemented to reduce processing time for 
certain frequent high-overhead instruction seguences. A secondary 
gain will be made in the areas of flexibility and storage 
utilization. 

II. General Design Overview 
Microprogram components 

Save .registers 

This microprogram saves the contents of the registers, which 
is a cemmon activity in interrupt handling, subroutine entry, etc. 
A, B, E f and are "pushed" onto the stack addressed by register 
F. (It is assumed that this stack pointer is initially loaded 
using an OTA instruction to select code 5.) Pushing is in the 
direction of higher memory addresses. The contents of A, B, E, 
and are not charged. 

This microprogram has been assigned to macro 105362. An 
example of its use follows. 

DEFINE SAVE MACRO 
SUBROUTINE ENTPY POINT 
SAVE REGISTERS ON ENTRY 



etc. 

Since a stack mechanism is used for saving of registers, 
nesting of saves is possible. Note that the save microprogram 
does no • checking for exceeding the size of the stack area. The 
size of this area must be carefully chosen to handle the maximum 
possible number of nested saves. 

This microprogram complements the save register program. It 
"pops" A, n, E, and from the stack addressed by register F. 

This microprogram has been assigned to macro 105340. An 
example of its use follows. 



SAVE 


EOU 


362B 


SUB 


OCT 







RAM 


SAVE 
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RESTR 


EQU 


340B 


SAVE 


EQU 


3 62B 


SOB 


CCT 







RAM 


SAVE 



RAM RESTR 
OMP SOB, I 



DEFINE RESTORE MACRO 
DEFINE SAVE MACRO 
SUBROUTINE ENTRY POINT 
SAVE REGISTERS ON ENTRY 

SOBRCUTINE PROCESSING 

RESTORE REGISTERS 
EXIT FROM SUBROUTINE 



%£.&& Z registgr 

This, microprogram loads the A register with the current 
content of the F register. This will allow saving the value of F 
accross power failures. 

This microprogram has been assigned to macro 105220. An 
example of its use follows. 



READF EQU 
RAM 
STA 



220B 

READF 

SAVEF 



DEFINE READ F MACRO 
LOAD A FROM F 
STORE F VALOE 



SAVEF ESS 



This micr 
register. Ch 
unpacking can 
is defined as 
Bit is th 
byte 1 (bits 7 
byte into A 
The byte iddr 
register. Th 
after loading 

This mic 
example of its 



oprcgram a 
aracter h 
be facilit 
a word add 
en used to 
-0) . The 

register 
ess is s 
a micropro 
A. 
roprogram 

use folio 



Load .byte 

Hows loading cf bytes (8 bits) into the A 
andling, message handling, and buffer 
ated by this microprogram. A byte address 
ress shifted left one bit into bits 15-1. 

address byte in the word (bits 15-8) or 
load byte microprogram loads an addressed 

bits 7-0 and clears A register bits 15-8. 
upplied to the microprogram in the B 
gram increments B to the next byte address 



has 

vs. 



LBYTE EQU 
LDB 
RBL 
RAM 
STB 



320B 
BYTEA 

LBYTE 
NEXTA 



been assigned to macro 105320, 



DEFINE LOAD BYTE MACRO 
GET ADDRESS OF HORD 
DEVELOP ADDRESS OF BYTE 
LOAD THIS BYTE 
SAVE ADDRESS OF BYTE 1 
(A NCS CONTAINS 000377) 



An 



BYTEA DEF 



DATA 
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DATA 
NEXTA 



OCT 
ESS 



177401 
1 



Store byte 

This microprogram is the store counterpart to load byte. It 
will be useful in buffer packing and ether kinds of character 
handling. As in the case of load byte, the B register is used to 
address individual bytes. A register bits 7-0 are stored into the 
specified location without modifying the accompanying byte in the 
same word. A register bits 15-8 are ignored, and the contents of 
A are not altered. B is incremented to the next byte address. 

This microprogram is assigned to macro 105300. An example of 
its use follows. 



SBYTE 


EQU 


3 00B 




IDB 


BYTEA 




RBL 






1NB 






LDA 


ONE 




RAM 


SBYTE 




STB 


NEXT 


BYTE A 


DEF 


DATA 


DATA 


ASC 


10, A 


NEXT 


BSS 


1 


ONE 


asc 


1, 1 



DEFINE STORE BYTE MACRO 
GET ADDRESS OF WORD 
DEVELOP ADDRESS 

OF BYTE 1 
GET CHARACTER W 1 H 
STORE THE " 1" 
SAVF NEXT BYTE ADDRESS 
(DATA NOW CONTAINS W A1 M ) 



En^us 

Many operations in the project involve the use of queues 
which are maintained as linked lists of elements. For each such 
queue, a pair of queue control words is maintained. The first 
word addresses the first element in the queue (the head), and the 
second word addresses the last element in the queue (the tail) • 
An empty queue is defined such that the head is and the tail 
points to itself. 

The enque microprogram places an element on a queue. 
Register A addresses the pair of queue control words and register 
B addresses the element to be added to the queue. (the link word 
for an elemant is assumed to be at the address in B minus one.) 
The microprogram causes a skip whenever the element is added to a 
non-empty queue. Normally, the enque microprogram places the 
element at the end of the linked list (via the tail) • However, 
the element may optionally be placed at the beginning of the 
linked list. This is referred to as a priority enque. Registers 
A and B are not altered. 
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ENQ 


EQU 


240B 




LDA 


QCWA 




LDB 


ELA 




BAM 


ENQ 




OMP 

« 


FIRST 


QCWA 


• 
DEF 


HT 


ELA 


EEF 


ELEM 



This microprogram is assigned to macro 105240. An example of 
its use follows. Macro 105257 provides the optional priority 
enque. 

DEFINE ENQ MACRO 
ADDRESS OF HEAD, TAIL 
ADDBESS OF ELEMENT 
ENQUE THE ELEMENT 
(QOE0E WAS EMPTY) 
(QUEUE WAS NOT EMPTY) 

ADDBESS OF HEAD, TAIL 
ADDRESS OF NEW ELEMENT 

Deq u^ 

The deque microprogram removes an element from a queue. A 
skip is performed whenever an element is successfully removed from 
the queue (queue was non-empty) • As in the case of the enque 
microprogram, register A addresses the head and tail words. The B 
register is used to return the address of the dequeued element. 
Begister A is not altered.. 

This microprogram is assigned to macro 10 5260. An example of 
its use follows. 

DEQ EQO 260B DEFINE DEQ MACRO 

ADDBESS OF HEAD, TAIL 



EQO 


260B 


LDA 


QCWA 


BAM 


DEQ 


JMP 


EMPTY 



GET AN ELEMENT 
(Q0E0E IS EMPTY) 
(QUEOE WAS NOT EMPTY) 
• 
QCWA DEF HT HEAD, TAIL ADDRESS 

In the event the, queue is enpty (no-skip return), the B 
register will contain zero. 

k2SL§t h. iMSlSi 

This microprogram facilitates access to control blocks, 
tables, etc. It uses the B register as the base address of a'n 
area of storage up to 32 words long. An index value from -16 to 
15 may then be added to the contents of B in order to load A from 
any of these 32 locations. The index value is supplied as a 
signed four bit number in the low order five bits of the macro 
which invokes the microprogram* B is not altered by the 
microprogram. 

This microprogram is assigned to macros 105020 to 105057. 
Note the special use of bits 4-0. An example of its use follows. 
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LAI 



EQU 
LDB 
RAM 



OUOB 
ATAB 
LAI4-1 



DEFINE LOAD A INDEXED MACRO 

SET EASE ADDRESS 

LOADS CONTENTS OF H1 INTO A 



BAM 



LAI+1U 



LOADS CONTENTS OF H1U INTO A 



ATAB 


EEF 


HO 


HO 


BSS 


1 • 


W1 


ESS 


1 




ESS 


12 


W1U 


ESS 


1 

Store A indexed 



Store A indexed is exactly the store counterpart of load A 

indexed. Refer to that description for basic details. 

This microprogram is assigned to macro 105060 to 105117. 

Note the special use of bits U-0. 

£££ gener.at|.cn 

This microprogram computes cyclic redundancy check characters 
required in telecommunications error detection procedures. The 
CRC result is developed by operating on each character of the 
message with this microprogram. A character is supplied to the 
microprogram in the A register bits 7-0. The CRC result is 
developed in the word following the macro invoking the 
microprogram. 

This microprogram is assigned to macro 105150. An example of 
its use follows. A and B are not modified. The initial value of 
the CRC result should be zero. 



CRC EQU 150B 

LDA NEXTC 

RAM CRC 

RSULT OCT 



DEFINE CRC MACRO 
NEXT CHARACTEF TO BE 
APPLY TO CRC RESULT 
CRC RESULT 
RETURN TO HERE 



APPLIED 



Herd move 

Hord move transfers blocks of "n" words of storage from one 
area of aeiory (source) to another area (destination) • The A and 
B registers supply the source and destination addresses 
respectively, and the count or M n w is supplied as an inline 
parameter in the location following the invoking macro. The count 
must be a positive integer. A negative or zero value will result 
in an effective NOP. The microprogram is interruptable. For this 
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reason, it requires a second inline parameter word for interrupt 
use which must be assembled as zero. A and B will be modified* 

This microprogram is assigned to macro 105200, An example of 
its use follows. . . - 

WMOVE EQU 200B DEFINE WORD HOVE MACRC . 

IDA FROM LOAD SOURCE ADDRESS 

LDB TO LOAD DESTINATION ADDRESS 

RAM WMOVE MOVE DATA 

DEF FIVE ADDRESS OF AMOUNT TO MOVE 

CCT 



FROM DEF *+1 

ASC 5,ABCD3FGH7J 

TO DEF *«-1 

ESS 5 

FIVE DEC 5 

E£te move 

Byte move is like the word move microprogram with these 
additional facts. Bytes rather than words are moved. A byte is 8 
bits. The source and destination addresses in A and B must be 
byte addresses. (A byte address is defined as: bits 15-1 contain 
the wcrd address and bit contains the byte number.) 

This microprogram is assigned to macro 105120. An example of 
its use follows. 

DEFINE BYTE MOVE MACRC 

GET SOURCE ADDRESS 

CREATE BYTE ADDRESS 

GET DESTINATION ADDRESS 

CREATE BYTE ADDRESS 

MOVE THE BYTES 

ADDRESS OF AMOUNT TO HOVE 



BMOVE 


EQU 12 0B 




IDA FROM 




CLE,ELA < 




IDB TO 




CLE r ELB i 




RAM BMOVE 




DEF NINE 




CCT 

a 


FROM 


DEF **1 




ASC 5,A1B2C3D4E5 


TO 


DEF **1 




ESS 5 


MINE 


DEC 9 



Following the above execution, the characters W A1B2C3DUE W will 
have been moved. The byte following the E in the destination area 
will not have been modified. 



2-79 * 



Translate 



This microprogram performs a 
characters according to a translate 
address of the translate table and X 
translated, then: 



translation of a string of 
table. If t is the byte 
is a character (8 bits) to be 



X < — character at location Y.+ X 

The A register provides the word address of the translate table, 
while B supplies the byte address of the string to be translated. 
An inline parameter provides a positive count of the number of 
characters to be translated. The microprogram is interruptable. 
Hence, the inline count is volatile and may be modified, A and B 
are modified. 

The microprogram is assigned to macro 105160. An example of 
its use follows. 

DEFINE TRANSLATE MACBC 
LOAD TRANSLATE TABLE ADDRESS 
LOAD ADDRESS OF STRING 
HAKE IT A BYTE ADDRESS 
TRANSLATE THE STRING 
AMOUNT TO TRANSLATE 



TRSIT 


EQU 


160B 




IDA 


HAPAD 




LDB 


SAD 




CLE, 


ELB 




RAN 


TRSLT 




DEC 

• 


\ 


MAPAD 


DEF 


*-101B 




ASC 


5,1234567890 


SAD 


DEF 


*+ 1 




ASC 


3, AIEECG 



Following the above execution, the characters ,, AIEBCG W will have 
been replaced by the characters "19523G". 

IHiliESSi a dd ress list 

This microprogram generates a list of indirect address 
pointers useful in accessing unique storage areas. Such a 
technique has been used in the programming of serially reuseable 
modules to access individual control blocks. The address in 
register A is deposited into the location addressed by an inline 
address list pointer. A is then incremented as is the location 
pointer, and the process is repeated for a specified number of 
pointers. The B register is left untouched. A will be updated by 
the number of pointers generated. 

The microprogram is assigned to macro 105000. An example of 
its use follows: 
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IAL 


EQU 


000B 




LDA 


ILIS 




GAM 


IAL 




DEF 


PTRS 




DEC 

• 


3 


ILIST 


• 
DEF 


A 


A 


ESS 


3 


PTRS 


ESS 


3 



DEFINE IAL MACRO 
LOAD ADDRESS OF STORAGE AREA 
GENERATE ADDRESS LIST 
ADDRESS OF ADDRESS LIST 
NUMBER OF POINTERS 



Following execution of the above example, PTRS will contain values 
equivalent to: 



CEF 


A 


DEF 


A*1 


CEF 


A*2 



EQU 


221B 


RAM 


PFRIO 


STC 


10B 


OCT 






£2*.2I £ai.i I/Q 

This microprogram is used to simultaneously execute an I/O 
instruction and mark the occurance of this execution. This is 
done by using a macro followed by the desired I/O instruction and 
a flag word which •will be set non-zero by the microprogram. I/O 
instructions are limited to those not involving A or B. 

The microprogram is assigned to macro 105221. An example of 
its use follows: 

PFRIO EQU 221B DEFINE THE MACRO 

EXECUTE STC AND FLAG SAME 

FLAG WORD 

Following execution of this example, the control bit of the 
selected interface will have been set (normal STC) , and the OCT 
will have been changed to a one. 

P2ii££ fail ex it 

This microprogram allows a module to exit from a subroutine 
and simultaneously clear the subroutine entry point location. 
This is especially useful in interrupt handlers to allow for the 
simple inspection of the value of the interrupt entry point in 
order to determine if an interrupt is active. This is a necessary 
decision for power recovery processing. 

The microprogram is assigned to macro 105223. An example of 
its use follows: 
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PFREX EQO 223B DEFINE THE MACRO 
RAM PFREX EXIT THROUGH 1.10 
CEF 1.10 

Control is transferred to 1.10 indirectly just as in a JMP 1.10,1. 
However, in addition, the 1.10 location will be- cleared. 

Power fail exit with I^O 

This microprogram incorporates the actions of power fail I/O 
and power fail exit. That is, an I/O instruction is executed and 
flagged, and an indirect exit is made with the entry point being 
cleared. 

The microprogram is assigned to macro 105222. An example of 
its use follows: 

PFREI EQU 222B DEFINE THE MACRO 

EXECUTE THE MACRO 



EQU 


222B 


BAM 


PFREI 


STF 


0B 


CCT 





DEF 


1.10 



The STF instruction is executed and the inline OCT flag is set 
non-zero. Control is given to the location whose address is in 
location 1.10. 1.10 is cleared. 

III. Design Structures 
Microprogram structure. 

Some of the efficiency of the microprograms is due to the 
design assumption that the WCS module is module one. It is 
therefore the macro "entry" module. This can eliminate some 
wasted microprocessor cycles for jump tables. 

In the remainder of this section, each of the individual 
microprograms is discussed in detail. 

These microprograms will use the F register as a stack 
pointer. This has two impacts. First, memory protection can not 
be used since the ♦we uses of the F register would conflict. 
Second, no other microprograms may use the F register 
indiscriminant ly . This use of the F register is justified on the 
basis of efficiency. Memory protection does not appear to be a 
future requirement, and other microprograms do not seem to be 
heavily restricted in not using F. It should be noted that the 
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basic instruction set never modifies F, should this use of F 
become a problem, other forms of save and restore can be 
implemented. However, all other forms will suffer an increase in 
execution time ov€r the current design. 

The save microprogram depends on the use of a macro having 
bit 1 set and bit clear (105xx2 or 10Sxx6). This is because the 
IR is used to develop the saved value of the register. Since 
saving of the registers requires three core writes (one for A, one 
for B, and one for E and 0) , it is desireable to have the 
microprogram initiate the first write as soon as possible* By 
assigning the macro 105362 to this microprogram, the primary jump 
table can be avoided. There ::o:&* the first microinstruction for 
this microprogram can initiate the first core write and does not 
have to be a JMP microinstruction. The microprogram thus fully 
executes in the minimum number of storage cycle times, 

While the core writes for A and B register values are 
occuring, the values of E and must be developed. This is done 
using the CNTR, Bit 1 of the CNTR is set if is clear by using 
bit 1 of the IH as a constant (hence the requirement for 105xx2 or 
105xx6). Also, if E is set, bit* of the CNTR is set. Hence, the 
net result of this macro is as follows: 

1, A is written to the location addressed by F. 

2, F is incremented. 

3, CNTR is cleared. 

4, CNTB(1) is set if is clear, (Thus, CNT»(1) saves the 
compleaent of 0.) 

5, B is written to the location addressed by F, 

6, E is transferred to FLG. 

7, F. is incremented, 

8, CNTR(O) is set if E is set. 

9, CNTR value is written to the location addressed by F. 

10, E is restored from FLG. 

11, F is incremented, 

gestgre r^gist^rs 

This microprogram performs nearly the inverse operation of 
the save registers microprogram, 

1, F is decremented . 

2, A core read for E and is started, 

3. is assumed set, 

4. FLG is set with bit zero from the data read from core. 

(This is the saved value of E,) 
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N 



5. P is decremented. 

6. A core read for B is started. 

7. E is leaded from FLG. 

8. is cleared if bit one cf the data from (2) is set. 
(This is the complement of the saved value of 0.) 

9. B is leaded from the data read from core. 

10. F is decremented. 

11. A core read for A is started. 

12. A is leaded from. the data read from core. 

££££ I register 

1. F is transferred to A. 

Load bv.te 

This microprogram mast initially have a default NOP in the 

IR. Therefore, IR is cleared by the JMP in the primary jump table 

This microprogram is also used as a subroutine by seme other 
microprograms. In this case, the JSB clears the IR. 

1. A 32 bit logical right shift of B and A places 13(15-1) 
in Sl(1u-0) and B(0) in A (15). (Address of word 
containing byte in S1 and byte number in A(15)«) 

2. A read of the word addressed by S1 is started. 

3. If A (15)' is clear, an ALF instruction is built in the 
IR. 

4. The data read is placed in Q as operated on by either 
two NOP's or two ALF*s. (Thus the desired byte is 
placed in 0(7-0) .) 

5. 3 is incremented. 

6. Q is transferred to A with A (15-8) cleared. 

7. The microprogram either returns to tyte move or exits 
phase three. 

Store byte 

This microprogram must initially have a default NOP in the 
IR. Therefore, the IR is cleared by the JMP in the primary jump 
table. This microprogram is also used as a subroutine by some 
other nicroprograms. In this case, the JSB clears the IR. 

1. B(15-1) are shifted to 51(14-0). FLG is set with B(0). 
(Address of word containing byte to S1 and byte number 
to FLG.) 

2. A read of the word addressed by S1 is started. 

3. B is incremented. 
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4. If PLG is clear, an ALP instruction is built in the IR. 

5. The data read is placed in Q as operated on by either 
two NOE's or two ALF's. (Thus the byte to be saved is 
moved to Q (15-8) .) 

6. Q<7-0) are cleared and Q is moved to S2. 

7. A (7-0) and s2(15-8) are merged and positioned either 
with two NOP's or two ALF f s. 

8. A core write is initiated. 

9. The merged value is written to core. 

10. The microprogram either returns to byte move or exits 
phase three. 



ISilJSS 



1. The address of the U*ua pointer is placed in S2. 

2. The CNTR is set from the IR for use in detecting the 
priority enque request. 

3. The new element link word address is placed in S3. If 
the request is not priority, S2 is changed to the tail 
pointer. 

4. A read of the appropriate pointer is started using S2. 

5. The tail pointer address is developed in S1. 

6. Q receives the old element address just read. SU 
receives the proper link word content for the new 
element. 

7. The carry flip/flop is set if the request is priority 
and the head was clear. 

8. A core write of the head or tail pointer is started. 

9. The contents of B are written into the pointer. (Tail 
or head now addresses new element.) 

10. If the request is not priority, then S1 is changed to 
rewrite the old element link rather than the tail. 

11. The link word of the new element is written from S4. 

12. If a priority engue and the list was not empty, the 
remainder of the microprogram is a NOP. 

13. a is written into the core location addressed by S1. 
(Old element now points to new tail element or for 
priority with an empty list, the tail points to the new 
element. ) 

m. The carry flop is set for non-priority requests to 
reflect the emptiness of the list. 



Cejue 



1. The head pointer is read into E. 

2. If B is clear, an exit is made. (P is not incremented. 
The list is empty.) 
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3. The link word of the degueued element is developed in 
S1 and is read. 

4. P is incremented, (The list is not empty.) 

5. The link word value just read is placed in S4. 

6. The head is rewritten with the value in S4. (Head 
pointer now addresses new head element.) 

7. If the head pointer is going to zero, the tail pointer 
is rewritten to address itself. 

Loaid an_d store A indexed 

These microprograms are very similar and will be described 
together. 

1. Bits 4-0 of the instruction register represent a signed 
index to be added to B. Due to the function of the AfiR 
5-bus micro-order, bits 9-0 are added to B first. The 
result goes to Q. If X represents bits 9-0 of the 
instruction register with bits 4-0 clear, then this 
step produces: Q=B+X+N where N is the desired index. 

2. X must be removed. Two subtraction steps now occur to 
remove X from Q. The final result (B+N) goes to S2. 
The value X is based on the macro assignment for the 
microprograms. 

3. For load, a core read is started to the address in S2. 
For stcre, a write is started. 

4. A is appropriately loaded from or stored to the memory 
location in question. 

CRC generation 

The CRC computation is a division of a message by an error 
detecting polynomial. The remainder of the division is the CRC 
result. By beginning with a clear CRC result and applying each 
successive bit of the message to the division process, the CRC 
result may be computed. This microprogram handles a character of 
the message and applies each of the 8 bits of the character 
successively. The polynomial involved here is: 

This is the standard CRC polynomial for IBM binary synchronous 
communications. In these ccmitunications, the CRC result is 
maintained with its low order bits in high, order positions of the 
computer memory wcrd. The division is carried out with 1 a bit 
shifts and modulo 2 addition (an exclusive or) • 
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For more details on the subject cf error detecting codes and 
on the technique used by this microprogram, refer to the following 
publication: 

James Martin, TeJ^rocess£&a Network O^gan^zat ^ o n ,. 
Prentice-Hall; Inc., Englewood CliffsT New Jersey, 
1970, pages 76-95. (especially pages 35 and 91-93) 

1« A and B are saved in S4 and Q respectively. 

2. CNTS is set for an 8 cycle loop using a constant value 
of 10 (octal) from the IB. (Hence, the requirement for 
a macro assignment of 105150.) 

3. A constant (polynomial) and an RAR instruction are 
built. 

4. The supplied character is moved from A to 8. 

5. The current CRC result (addressed by P) is read and 
rotated right into S2. A is cleared. 

6. B and A shift right together. B(0) becomes A(15). S2 
is then exclusive cr'ed with A. This applies the 
constant (or 1) part of the polynomial. Result goes to 
A. 

7. tf the result of 7 is a 1 in A (15) , then the remainder 
of the polynomial is applied. 

8. S2 is set with the new rotated value of A. 

9. CNTB will cause cycling on steps 7 through 9 for each 
of the 8 bits in E. A is cleared on JMP f s to step 7. 

10. The CRC result is rewritten to core. 

11. P is incremented. A and B are restored. 



Word move 



Normal processing 



1. The count addressed by the inline parameter is read and 
the result is loaded into Q (-count-1). If the result 
is not a positive value, the microprogram exits at step 
10. 

2. The destination address in B is moved to S2. 

3. A source word is read as addressed by A. 

4. A and E are incremented. 

5. S3 (or S4 if used in control store module or 2) 
receives the source word content. 

6. The count is decremented in Q. When zero a skip occurs 
to an exiting JMP to step 10. 

7. The destination word write is started using the address 
in S2. 
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8, The source content in S3 (or SU) is written to the des- 
tination. If an interrupt is pending, proceed at step 
11. 

9. B is transferred to S2 as the new source address. The 
microprogram continues at step 3. 

1C. P is incremented past the inline parameters and end of 
phase is set. 

Interrupt processing 

11. The count in Q is decremented, and the microprogram 
continues at step 10 if the count goes to zero. 

12. If more moving is required, the current count is 
rewritten to the location addressed by P and P is 
decremented to cause the macro to be re-executed. 

Ey.te move 

This microprogram uses the load and store byte microprograms 
as subroutines. 

Normal processing 

1. The count acquisition code in the move words 
microprogram is used as a subroutine to obtain the 
count. 

2. B is saved in SU as the destination address. A is 
moved to B as the first source address. 

3. Load byte is used to obtain the n*xt byte. 

<*. S3 retains the next source address returned by load 
byte in B. 

5. B is restored' with the next destination address from 
S4. 

6. S4 is usetf to retain Q accross store byt2 which also 
uses Q. 

7. The store byt3 is performed and Q is restored. The 
next destination address provided by store byte in B is 
saved in SU. If an interrupt is pending, proceed as in 
move words. 

8. B receives the next source address saved in S3. 

9. The count is decremented, and the microprogram exits if 
it goes to zero. Otherwise proceed at step 4. 

10. P is advanced beyond the inline count. End of phase is 
set. 
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Transla te 

This microprogram uses the load and store byte microprograms 
as subroutines. 

Normal processing 

1. The count is read into Q in two's complement form. If 
the result is not negative, an immediate exit occurs. 

2. The tyte address of the translate table is created in 
S4. 

3. The byte addressed by B is loaded (function byte). 

4. The address of this byte is retained in S3. 

5. The function byte is added to S4 to generate the 
address of the object Lyte within the table. 

6. The object byte is loaded. 

7. The address of the function byte is restored to B from 
S3. Q is saved in S3. (Store byte uses Q.) 

8. The object byte is stored over the old function byte. 

9. S3 is incremented into Q. (Count check.) If a zero 
results, an exit is begun. 

10. If an interrupt is pending, interrupt processing 
begins. 

11.. Processing continues at step 3 until the count goes 
zero when P is incremented to skip the inline count. 
Then end-phase is set. 

Interrupt processing 

12. A is restored. The- positive counterpart of Q is re- 
written as the inline count. 

13. P is decremented for reinvocation of the microprogram. 

indirect a, d dress list 

1. The inline parameter, which is the address of the 
indirect address list, is read from memory. 

2. P is incremented past this inline parameter. The B 
register is saved in register S1. 

3. The data read in 1 above is now moved to register B. 

a. A memory read is started to obtain the inline parameter 
which is the address list size. This information is 
transferred to the Q register, and P is incremented 
past the parameter. 

5. A memory write is started using the address contained 
in the B register. This is the address of a cell in 
the indirect address list. The contents of the A 
register are deposited into this location. 
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6. Both A and B are incremented, 

7. The count is decremented in Q. When this count, reaches 
zero, E is restored from S1 and end phase is set. 
Until this occurs, processing continues at step 5. 

1. The .first inlin? parameter is read using the P 
register. This is the I/O instruction which is to be 
executed. P is incremented to skip this parameter, and 
the IR is loaded with the instruction as read from 
memory. 

2. A memory write is started to the next inline parameter. 
This is the flag which will mark the occuranc€ c-f the 
execution of the I/O instruction. A constant one is 
deposited into this location. 

3. P is incremented to skip the inline flag. Then the IOG 
decoder is enabled to execute tha I/O instruction in 
the IR. . 

4. If the microprogram is in use by power fail exit with 
I/O, then a return from subroutine is effected. 
Otherwise, this is a nop and end phase is set. 

££*££ l^il iiii 

1. The inline parameter addressed by the P register is 
rea3 from memory. This is the address of the word 
which contains the return address. The contents are 
deposited into S2 . 

2. A read is now started using the address in S2. This 
will obtain the return address to which control is to 
be transferred. The value in that location is 
deposited into P. 

3. The location addressed by S2 is now written with a 
zero. This marks the fact that the exit has been taken 
and that no processing is active in the associated 
module. 

4. End phase is set. 

£P.i£I l^ii illi w ±^h I/O 

1. The pcwer fail I/O microprogram is invoked as a 
subroutine. 

2. The microprogram then falls into the power fail exit 
microprogram. 

IV. Implementation 
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All microprograms are tested and debugged using HCS. 
However, it is expected that in the final HP2000 ACCESS systems, 
PROMs will be turned with the microprograms described herein* 
These PHOMs will become a standard part of the CPU for the HP2000 
ACCESS I/O processor* 
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TERMINALS 



HEWLETT-PACKARD 2000 StfSTEM I/O PROCESSOR 

TERMINALS 
CONTENTS 

1. D.61 INTERCONNECT KIT DRIVER 

2. ICKH INTERCONNECT KIT HANDLER 
}. MJXH MULTIPLEXOR HANDLER 

4, I). 51 MULTIPLEXOR DRIVER 
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I. Introduction 

Tha D.61 Interconnect Kit Driver is designed for use in the I/O 
Processor of the Hewlett-Packard HP2000 ACCESS Time Share Basic 
System. It will provide buffering of input and output froa/to the 
System Processor and proper channelling of control-type 
information throughout the sjstem. 

II, Design Overview 

fissign assumpt ions 

Ihe hardware required for operation of the program includes a 
2100A processor used as the I/O Processor on a HI J2C00 ACCESS 
system. Also required is a processor interconnect kit (part 
number 12875B) . 

The software environment is assumed to contain the HP2C00 ACCESS 
I/O processor microcode. Also assumed are special purpose HP2000 
ACCESS driver extensions in the Do 51 multiplexer driver. 

The design approach uses as a starting point an analysis of the 
functions required of the I/O Processor and the buffered I/O 
requirements of Queued ,IOC. 

fiany of the functions requested of the IOP are of an asynchronous 
nature, unrelated to activity on the IOP, An example is tha 
PHONES command execution. To optimize performance, this driver 
will process these by dispatching appropriate appendages in co- 
existing drivers and the base level program. Base level 
appendages are also occassionally dispatched using the technique 
of unsolicited event notices. 

Another subset of the requirements for the driver is a buffered 
I/O interface with Queued ,ICC. This requires synchronization of 
an input from the System Processor with .IOC. HEAD calls and 
output to the SP with .IOC. WRITE calls. It is noted in the SP 
connection protocol that . all WRITE calls must be immediately 
followed by READ calls, so a special WRITE/READ operation • is 
provided. 
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Command Dispatcher - This mcdule will interpret commands from the 
SP and pass control to the module/routine responsible for 
execution of the command. 

External Appendages - ■ This M mcdule" consists of a collection of 
routines scattered throughout the system responsible for execution 
of asynchronous control/information commands from the system 
processor. Since these routines are coded in different, external 
modules, no specific outline of their functioning will be made 
here* However, Table 3 contains a list of the routines, entry 
parameters, and expected raturns to the SP where appropriate. 

Input Buffering - This module processes POC and POS commands to 
buffer data frcm the SP to the IOP. It also notifies the SP of 
Buffer Full and Buffer Empty conditions. 

Data Output - This service module is used to output commands to 
the SP. 

Output Transmission - This lodule handles transmission cf data to 
the SP. It also is responsible fcr execution of Backspace and 
Save^Restore Buffer Pointer commands. 

READ Interface - This module interfaces an .IOC. READ reguest with 
the Input Buffering module. It must reference and adjust table 
information to reflect input buffer availability. 

WRITE/READ Interface - This icdule interfaces an .IOC. WRITE/READ 
reguest with the Output Transmission module. -It also notifies the 
SP of data availability. 

3RITE CONTROL Interface - This module interfaces an .IOC WRITE 
CONTROL request with the SP. Control information from the user 
program is passed directly tc the SP. 

III. Design Structures 

One of the key features of the driver is simultaneous control of 
up to 32 data streams through a single .IOC. logical unit number. 
Implementation of this feature requires control tables in the 
driver for each of the 32 streams. This table, called a Logical 
Unit Table (LUT) is illustrated in Table 1. 



3-2 



^J2£ functional m odules 

The Command Dispatcher is entered to obtain commands from the SP 
and transfer control to the appropriate routine. It will 
relinquish control via a JSB with the following parameters set; 

A-register: Logical Onit Number 
B-register: Copy cf SP Command 

Tha algorithm used is as outlined below, 

1) Use bits 15-13 as offset into major command JMP table. If 
15-13 / 7, goto routine via JSB. On return goto step 3. 

2) If 15-13 = 7, use bits 4-0 as offset into micro-cemmand JHP 
table. Goto routine via JSB. 

3) On return clear flag to allow further SP interrupts. 
Terminate interrupt processing. 

See table 1 for a list cf SP commands and where control is 
transferred for the various commands. 

External Appendages are a collection of device specific routines 
used to quickly execute device specific SP commands. An example 
of such a command is ABT, which requires the HUX driver to change 
status of the user. No description of the processing requirements 
for each External Appendage is given here, but is given within the 
Base Design Specification for the module in which it is coded. 

The Input Buffering module is used to receive characters from the 
SP and assemble them into a lessage buffer. It obtains control to 
process the following SP commands: POC, KTO, IWT, ALI, STE, OWT, 
IBA, RLB, UIR, UNR, TPO, ABT, and POS. It may also transmit the 
following commands to the SP: BFL. And it may ultimately pass 
control to the terminator section of the READ Interface module. 
References to the LOT use the component name as shown in Table 1. 
Implicit in every LUT reference is subscripting by the appropriate 
device number. The Input Buffering module is also responsible for 
generating all unsolicited event notices. SP commands which 
unconditionally generate an unsolicited event notice arc INI, SSD, 
HUU, ULO, and NUC. The notification and interpretation of these 
commands are included as fcotnotes to Table 2. Buffer full* SP 
Input Killed, User Running, User Not Running, and User Aborted 
status indications may also cccur in unsolicited event notices if 
no processing is in progress when these status* are obtained. 
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Data Output consists of the single routine OMTOM. This nodule is 
entered for all IOE to SP ccsinand transfers. Upon entry, the 
coDoand should be in the A-register. Enter via a JSB OMTCM. 

The Output Transmission module has the responsibility of feeding 
the SP from a WRITE buffer one character at a time. It obtains 
control from the Command Dispatcher for the following ccmmands: 
FNC, SBP, RBP, EKS. It does net transmit any commands to the SP. 

The READ Interface module is responsible for initiating READ 
requests from .IOC. and queuing READ completions through .IOC. 
The user interface is through two .IOC. calls, as described below. 

READ FEQOEST 

JSB .IOC. 

OCT 1PPXX (XX is logical unit number) 

Reject Address 

Buffer Starting Address 

Buffer Length 

The high-order byte (bits 12-8) of the word immediately preceding 
the buffer is assummed to contain the logical stream number (sub- 
unit number) for the request. The driver will reject if a READ 
request is already pending. Status returns for the BEAD are given 
in Table 2. It should be noted that these status returns,, as 
everything else in this driver, are specific to the HP20C0 ACCESS 
system. 

The algorithms for this ffodule consist of one for READ request 
execution and cne for READ completion processing. READ request 
execution will adjust pointers in the Logical Unit Table for the 
Input Buffering module and if necessary transmit a BFE command to 
the SP to re-enable data transfer. READ completion processing 
will copy current status to the equipment table log and queue the 
input by a JSB .BUFR. Nc special handling is required by this 
routine. 

The WRITE/READ Interface is used to request data output to the SP, 
and 

turnaround of the device upon WRITE completion to READ status. 
The form of this call is as fcllcws: 
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WRITE/HEAD REQUEST 

JSB .IOC. 

OCT 2*2 XX 

Reject Address 

Buffer Start Address 

Buffer Counts (high byte is 

write count, low 
byte is read count) 

Again, the high-crder byte of the word immediately preceding the 
buffer is assumed to contain the logical stream number for the 
request. Further, bit 13 should be set if a parity error occurred 
and bit 14 should be set if a character was lost. Both should not 
be set, but parity errors will override lost characters. The 
driver will reject if a WRITE request is already pending. Status 
returns for the WRITE are given in Table 2. 

The algorithm for the WRITE interface is very straightforward, as 
outlined below. 

1) If WRITE/READ request already queued, reject. 

2) Store WRITE buffer information in LOT for Output Transmission 
module. 

3) Transmit HVL command to SP. 

4) Exit. 

Upon WRITE completion initiate a READ operation by direct entry 

to the BEAD interface. 

The WRITE CONTROL Interface module is used to transmit the 
following "special" commands to the SP: ABR, ETO, and UHU. These 
may all be sent via the following .IOC. call. 

WRITE CONTROL REQUEST 

JSB .IOC. 
OCT 2J24XX 
Reject Address 
Buffer Address 
DEC 1 (constant) 

A reject will never occur. Ihe "buffer address" should point to 
ona word, consisting of the command to be sent to the SP. Upon 
return, the request will be completely executed; hence no 
completion notice will be given. 
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The execution algorithm consists of loading the command to 
transmit, calling the Data Output routine, then returning. For 
reference, ABR is an Abort reguest, code OCT 1611000 (00 IS Logical 
Stream number); ETO is ENTER time out, OCT 160003; OHO is Oser 
huna. up, OCT 160004; - and ADR is Allocate Device for RJE, OCT 
160N06 vhere ON is the logicel unit number. 

Power recovery processing 

Much information about restoration of the interconnect kit 
following a power failure is outlined in the D.04 Power 
Fail/Restart module specifications. (Sea "Relationship of D.04 to 
the System Processor. ") There can be found details on the data 
exchanged between the IOP and SP during power recovery as well as 
a description cf interface flag restoration. 
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Table 1 
LOGICAL UNIT TABLE DEFINITION 

• IB1. Input Buffer Pointer 

• ILL input Buffer Length 
.ISTA Input status * 

• ISAV Input Save Word 

• 0B1. Output Buffer Pointer 
. 0L1. Output Buffer Length 

• CSTA Output Status ** 

• OSAV Output Save Word 

• CSAL Output Save Length 
.ICP Input Current Pointer 

• ICL Input Current Length 

. OCP Output Current Pointer 

• CCL Output Current Length 

* .ISTA bits have the fol lowing definitions: 

7-0 Copy of EQT Status for streaa. Cleared by operation 
completions; if any bits set on READ call, operation 
terminates imaediately. 

8 HflFE" nust be sent to start read. 

9 Input character saved in •ISAV. 

10 RLB received for aessage. 

11 Character 2 saved in .ISAV. 

12 IBA indicated to base prograa. 

** .OSTA bits have the following definitions: 

15 BPSAV - Buffer Pointer is saved. 

14 WRITE/BEAD operation in progress. 
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Table 2 
EQT STATCS BIT DEFINITIONS 

r 7 .... 6 -|— - 5 4 3 [ 2 1 

I » II I 111 

I Buffer J Start | Allow | SP | User | User I Tape | User 

| Full | ENTER | Mux | Input | Running | Not J Mode | Aborted 

| | Timing* | Input | Killed | | Running j Cn j 

I I I I I I II 



Note: A kit on indicates condition is true* Bit off has no 
meaning. 

The definitions of the above and associated actions required are 
listed below: 

B luf fer full — This indicates a READ operation has terminated 
under conditions reguiring another READ to follow. Such 
conditions are READ buffer filled or owt state entered. The 
next operation scheduled should be a READ operation* It nay 
also occur in an unsolicited event notice if the SE attempts 
to transfer data while co input buffer is assigned. 

§£&££ ENTgR lisina — This bit is set if ENTER timing is reguested 
by the SP at the termination of a READ operation. It cannot 
occur unsolicited. Tte ENTER time parameter, in seconds, 
will be returned as the last character in the buffer. After 
receiving this notice a MUX READ should be initiated and the 
ENTER timing should be started. 

Allow MU X input -- This indicates the SP has reguested a MUX READ 
" "operation. It cannot occur unsolicited. A MUX READ should 
be started. 

5E l££ii£ billed -- This cccurs as the termination of a READ 

"" operation~and indicates the data should be purged instead of 

output to the MUX. It may occur unsolicited, also, in which 

case current MUX output should be purged, followed by a MUX 

READ. 

User runn ing — This may occur at the completion of an operation. 
It indicates a state transition from conversational to IRUN 
mode. 



-j 
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User, not jjunn^ng — This also may occur at the completion of an 
operation. It indicates a state transition from BON to 
conversational mode* 

Ta pe mode on — This may cccur only in the completion of a READ 
operation* It indicates a state transition to TAPE mode, and 
processing should be adjusted accordingly. 

Usj-sr. aborted — This is set when an ABORT is indicated by the SP. 
It implies the User is Kot Running; it does not purge active 
I/O on the device. It may occur at operation completion or 
as an unsolicited event. 

Unsolicited e^vjjit ext ensi on 3 

In the case of an unsolicited event notice, the above status vill 
be returned in bits 7:0 of the B-register. Additional status 
returns are defined as follows: 

Bit 12 — '.System Shut Down 
Bit 13 — Hang User Op requested by SP. 
Bit 14 — USer Logged On indicated by SP. 
Bit 15 — Hew User Called indicated by SP. 

Bits 11:6 of the A -register %ill contain the device number. 

An unsolicited event with status of all zeros indicates an INIT 
request from the SE. 
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Table 3 
SP CCMKAND DEFINITIONS 



Bits 15:13 of all coaaands received from 
coaaand value. Represented in octal, these bi 
00 to 16. Obviously, aore SI conaands are def 
vill permit. Therefore, one of these commands 
M aicro-coded w command with the actual comman 
bits. In many cases, both priaary and micro- 
bits 12:8 to indicate the TSE port number. Se 
use bits 12:7 to indicate a TSfi logical uni 
other commands use these and other bits fo 
purposes. In the suaaary which follows, th 
noted. Several coaaands are followed by a s 
froa the SP. This mechanism is used to supply 
such indicators. Host commands do not requi 
SP. However, for those which do, the response 
notes. 



the SP contain the 
ts give a range of 
ined than this range 
is interpreted as a 
d indicated by other 
coded commands use 
veral other coaaands 
t nuaber. Certain 
r entirely different 
ese exceptions are 
econd parameter word 

length and other 
re a response to the 
s are outlined as 



P riiary c omma nds 



Comnand Mnemonic. £M2ii2B 



00 


POC 


02 


STE 


04 


STP 


06 


PHO 


10 


PCF 


12 


POS 


14 


TIN 



16 



Process output character 
Start enter timing 
Subtype information 
Phones timing 
Perform control function 
Process output string 
Terminal information 

Micro-codad ccmmar.d 



Parameter <b its> N otes 

Character <7:0> " 

Time in seconds <7:0> 
Subtype <7:0> 
Time in seconds <7:0> 
Function <6:C> 1 

String length <7:0> 2 

Port<12:8> 
Hicro-command <5:0> 
Micro-command <5:0> 



Hicrocommands 



Command Mnjgmcji £c Fjjn££j.on 



00 — Micro-micro-ccmmand 

01 OIR User is run ring 

02 UNR User is not running 

03 IHT Input wait 

04 HUU Hang user up 

05 ULO User logged en 

06 EON Echo on 

07 EOF Echo off 

10 TPO Tape mode on 

11 STR Start timed retry (ASCII files) 



N otes 
3 
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12 


NUC 


13 


KTO 


1U 


ALI 


15 


OBT 


16 


IBA 


17 


ADV 


20 


RDV 


2-1 


ALB 


22 


XRB 


23 


BKS 


24 


KDO 


25 


FNC 


26 


RJE 


27 


ABT 


30 


PIS 


31 


NOP 


32 


SCI 


33 


RLB 


34 


NOP 


35 


SBP 


36 


RBP 


37 


CBE 



New user called 

Kill terainal output 

Allow input 

Output wait 

Is buffer available 4 

Allocate device (ASCII files) 5 

Release device (ASCII files) 6 

Allocate output buffer (ASCII files) 7 

Transfer input buffer (ASCII files) 8 

Backspace 

Kill device output (ASCII files) 

Fetch next character 

RJE command 9 

User aborted 

Process input string 

(Reserved fcr future use) 

Send core iiage 10 

Release buffer 

(Reserved fcr future use) 

Save buffer pointer 

Restore buffer pointer 

Console buffer empty 

IIH Jicrocoiaaanqs 



00 VTP What terminal type 

01 , SBL Send buffer length 



Notes 

1, PCF is an ASCII files related command. PCF returns one of 
the following responses to the SP : 

- command accepted 

1 - device not ready 

2 - illegal data input from device 

3 - hardware read error on device 

4 - unrecoverable device error 
-1 - no buffer available 

-2 - device end of file 

-3 - no data available frcn device 

In the non-zero cases, the response is simply an echo of the 
current device status. 



2. POS responds to the SP as follows: 



3-ir 



- comaand accepted 

-1 - no buffer available 

3. The . following micro-micrc-coded commands are defined by bits 
9:7 of the command: 

INI Initialize IOP 

1 KSN Cold dump 

2 SNP Send number of ports 

3 SDT Send device table 
U SSD System shutdown 

For the INI command, the following SP response is given: 

- RJE is present in system 

1 - RJE is not present in system 

Other commands yield obvicus responses, 

4« IBA responds to the SP as fellows: 

- buffer is available 
-1 - no buffer available 

5. ADV is a two word command* The second word received from the 
SP contains the buffer length to be associated with the 
device being allocated* 

6* RDV responds to the SP as follows: 

- device was released 
-1 - device is still busy 

7. ALB is a two word command. The second word received frcm the 
SP contains the buffer length to be allocated. ALB then 
responds the SP as follows: 

- buffer was allocated 

-»0 - same as PC? (see ncte 1) 

8* XRB responds to the SP as fellows: 

- buffer available 

-*Q - same as PCF (see ncte 1) 

9. RJE responds to the SP as follows: 

0. - buffer available 
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-1 - no buffer available 

10 • SCI is a two word comaand* The second word received frca the 
SP contains the start address for the area of the ICP to be 
returned to the SP. 
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Iijncl;4on^l aescjEJB.Usa 

The interconnect kit handler (ICKH) manages communications 
between the system processor (SP) and the I/O processor (IOP) at 
the user program level* Those communications consist of the 
dialogue between a separate handler, managing time share 
terminals, and the system processor. By definition the inter- 
connect kit has characteristics which require special 
consideration. 

1. Although the interconnect kit is a single physical 
device, it must support 32 separate and independent 
data streams (one' for each potential user of the time- 
share system) • 

2. The identity of these separate data streams must be 
maintained in its interactions with other handlers as 
well as with .IOC. 

3. Each of the data streams is bidirectional, used for 
messages from the SP to the external handler and for 
messages from the external handler to the SP. 

f*. For reasons of performance the ICKH and the handlers 
with which it interacts will not utilize the dynamic 
buffering facilities offered by the buffer manager. 

5. The system processor "controls" each data stream. The 
nature of communication is that every input tc the SP 
evokes a response in the fere of a command or output. 

The impact of these characteristics on the ICKH handler is 
outlined below: 

1. Control and status information must be maintained for 
individual data streams (see Local data structures 
below). 

2. Stream identification is embedded in all communications 
with external routines. The necessary information is 
maintained in the control words attached to each 
buffer. 

3. Since information flow between handlers is 
bidirectional, control information in the form of a 
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coaaand code and status information is attached to 
every buffer queued* 

4. Buffers are aanaged by the ICKH. All data buffers used 
are dedicated to the handler. The ICKH queues eapty 
buffers for other handlers to fill; or alternatively, 
queues full ones as output to another handler and 
receives them back as work in its own queue. This is in 
lieu of the dynaaic facilities of the buffer manager. 

5. Buffering and processing techniques are dictated by the 
SP through its responses to inputs it receives. These 
are coaaunicated to the handler through coapleted event 
notifications. 

A data streaa can be in one of three operating states. The 
states and buffering techniques associated vith each are: 

1. Conversation state - all data received f rca another 
handler and transaitted to the SP is single buffered. 
Every transaission to the SP is followed by a 
transaission jiga the SP. If a transaission fyoa the 
SP is terminated with an indication of aore output to 
follow, double buffering is used. Outputs terminated 
with a transait coaplete indication cause input froa 
the other handler tc be enabled. 

2. Running state - input froa the other handler is enabled 
only at the direction of the SP and is single buffered. 
Outputs froa the SP to the other handler are double 
buffered under the saae conditions as conversation 
state. Outputs terainated with a transait coaplete 
indication cause input froa the SP to be enabled. 

3. Tape state * input froa the other handler to the SP is 
dou tie- buffered. There is no output to the other 
handler in tape state. 

State transitions occur at the direction of the SP either 
through an explicit coaaand cr iaplicitly due to an unexpected 
occurrance. 



3-15 



Implicit to this discussion is the understanding that each 
data stream is independent of all others* Processing reguirements 
are determined by the "state" of the streaa as described 
previously* The "initial" ot native state of each data stream is 
conversation. State transitions occur because of an explicit 
directive from the SP or due to the occurence of an unexpected 
event. The valid state transitions and causes are: 

1* conversation to running - occurs when the SP indicates 
(JIB (user is running) 

2. conversation to tape - occurs when the SP indicates TPO 
(tape mode) 

3. running to conveisation - occurs when the SP indicates 
OHB (user not runcing) or ABR (user aborted) 

4. tape to conversation - occurs on the first data output 
from the SP. 

5. tape to running - occurs when SP indicates UIR (user is 
running). 

Because of performance considerations relative to the SP 
software and because the ICKB (and the IOP) are in effect driven 
by the SP, the sequence of operations is normally a WRITE to the 
SP immediately followed by a BEAD terminating with output from the 
SP and/or an indication cf action to be performed. The 
indicators, as documented in Base Design Specifications of the 
Inter-connect Kit Driver are: 

1. Buffer full (BEL) - the SP has data to send 

2. Start ENTER timing (ENT) - the SP requests a timed read 
from the terminal 

3. Allow HOX input (ALI) - the SP requests an untimed read 
from the terminal 

4. SP Input Killed (SIK) - all output operations to the 
mux should be purged and an input is requested. 

5. User running (Ulfi) - directs a state transition from 
conversation or tape. to running 
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6. User net running (UNR) - directs a state transition 
from running to conversation 

7. Tape mode on (1H0) - directs a state transition from 
conversation to tape 

8. User aborted (AEB) - directs a state transition from 
running to conversation 

9. no indicators on at the termination of a READ or 0RITE 
is a valid return subject to state dependent processing 

Unsolicited events can occur to direct: 

1* Buffer Full (BFL) - indicates SP output pending 

2. SP Input Killed (SIK) * indicates a request to purge 
terminal output 

3. User Aborted (AE8) -^directs a state transition froa 
running to conversation 

4. Hang user up (BOO) * the SP requests a user be 
disconnected 

5. User logged on (ULO) * the SP indicates a user has 
logged on 

6. Nev user called (KUC) - the SP indicates a new user has 
called 

7. System Shutdown (SSD) - the SP is shutting down and all 
terminals should be disabled. 

8. Initialization (IHI) - the SP is directing 
reinitialization cf the system 

In addition there is one event which is processed as an appendage 

to the ICK driver: 

1. Phones (PHO) - a phones timing parameter has been 
received 
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ICKH consists of four major segments; an I/C complete 

segment, a Primer segment, an Initialization segment, and a Timer 

segment* Each of these if outlined in some detail below and in 
the accompanying flow charts. 

The initialization segment (ICKHI) is entered at system 
startup time (i.e., IOP load). Processing consists of: 

1. initializing all SIE indicators 

2. acquire and store identification for the ICK and MDX 
handlers. 

3. exit to the calling routine 

The initialization segment is reentered at system INIT time 
(i.e., SP startup) and the processing proceeds as follows: 

1. purge the queues for the ICK and MUX handlers 

2. . issue a Clear call to the interconnect driver. 

3. empty the ICK queue and make buffers available. 

4. purge all TQE's and set stream status word to zero. 

5. queue an ENABLE operation on each data stream. 

6. exit to the calling routine. 

The Primer entry (ICKHF) is activated whenever another 
handler has queued work for the ICKH. Processing proceeds as 
follows: 

1. obtain gueue entry from queue manager 

2. locate proper SIB 

3. branch to appropriate processing state routine 
Conversation state processing (FCON) 

1. determine queue entry type and process accordingly 

2. Terminal input - issue WRITE/READ call to the ICK 
driver and exit. . . All writes contain status as 
comiunicated by the mux handler. If the line connect 
flag in BCW8 is set, start LOGON timing. 
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3. Empty buffer return (NOP) - mark buffer as available if 
flags w=l=0=P=c=D=C* Otherwise use the tuffer as 
directed by those flgas and exit* 

4. Control (break or line drop) - issue a WRITE CC8TBQL to 
the ICK driver witlj the appropriate indicator set and 
exit. 

5. Control (line ccnnect) - queue BEAD through the queue 
manager, queue tiier element, L-1, exit* 

Running state processing (PRtJN) 

1. determine queue entry type and process accordingly* 

2. terminal input - if ENTER timing is in progress, purge 
the TQE and insert time in BCW9. Always issue 
WRITE/READ call to ICK driver, then exit* All writes 
contain status as communicated by the mux handler* 

3* empty buffer, return (NOP) - same as conversation state 
with the follwoing exceptions* If W=1, queue a zero 
length write to KUXH with Bit 15, BOM set to 1, clear 
9 and exit* If BCW1 Bit15=1, start ENTER statement 
timing, queue a READ to the terminal, and exit* 

4. Control (break or line drop) - issue a WRITE CONTROL to 
the ICK driver with the appropriate indicator set, then 

exit. 

Tape state processing (PTAP) 

1. All work queued is input from the terminal* Issue a 
WRITE/READ to the ICK driver, then exit* All writes 
contain status as communicated by the mux handler* 

2. or CONTROL (lite drop) - issue a WRITE CONTROL 
indicating user hung up and exit* 

The exit procedure for ICKHP is a JHP *COM. 
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The I/O complete sagient (ICKHC) is activated by completed 
event notifications for the ICK. ICKHC processing is state 
sensitive and proceeds as follows: 

1. obtain I/O complete entry 

2* locate appropriate SIB 

3. observe state change indicators, change state if 
necessary and bratch to processing^ state routine. 

Conversation state processing (CCON) 

1. determine event type and process as follows 

2* SP Output - if character count is non-zero, gtteue 
output as WRITE through gueue manager, else free 
buffer* Then, 
a* If BFL=1, issue a BEAD to the ICK driver if a 

buffer is available else set 0=1* Exit* 
b* If ALI=1 cr ALI=BFL»SIK=0, gueue a buffer with 

BEAD reguested through the gueue manager if a 

buffer is available, else set 1=1. Exit* 
c* If SIK=1, gueue an available buffer with CCNTBOL- 

POBGE reguested and set 1=1* If no buffer is 

available set P=1. Exit* 

3* Initialize (INI) - jump to system restart routine 

4* Hang user up (HUU=1) - gueue a buffer with control 
disable* Queue a timer element vith .1 sec interval, 
set U=L»E=0, and exit 

5* Oser logged on (UL0=1) - set L=0,0*1, if T*1 purge 
the timer gueue element and exit. 

6* Mew user called (NUC) - set L=1,U=1, gueue timer 
element with interval=PHONE, and exit* 

7. System Shutdown (SSD) - disable timer routine, I/O 
complete segment, and all data streams* Beset to 
native state with no operations pending* 

Running state processing (CRON) 

1* Determine event tvpe and process accordingly 
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2. SP Output - if character count is non-zerc, queue 
output as WHITE through queue manager, else free the 
buffer and then, 

a. If BFL=1, or ALI=BFL=SIK=ENT=0, issue a 
READ to the ICK driver if a buffer is 
available, else set 0=1. Exit. 

b. ALI=1 , queue a READ through the queue 
manager if a buffer is available, else set 
1=1. Exit. 

c. SIK=1, queue a COHTROL-PURGE through the 
queue aanager if a buffer is available and 
set 1=1. Else set P=1. Exit. 

d. ENT^I, set E=1 queue zero length WRITE to 
terminal and save tine parameter. If no 
buffer is available for writing set V*1 and 
exit. 

3. Hang User UP (HUU) - queue a DISABLE request, set a 
timer with a one secend expiration, and set U=E 3 L a S s 0. 

Tape state processing (CTAP) 

1. determine entry type 

2. must be ALI=1, queue READ through queue manager, 1=1, 
exit. If ALI=0, then return to Conversation state. 

The exit procedure for ICKHC is a JMP .COM. 
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10 STATE 








COMPLETE 




CONVERSATION 


INDICATORS 




READ 


UNSOI 


BFL 




X 


X 


ENT 








ALI 




X 




SIR 




X 


X 


OIB 




* 




UNR 








TMO 




* 


• 


ABR 








HUO 






X 


OLO 






X 


NUC 






X 


RLB 




X 




(BFL=ALI=SIK 


=0) 






INI 






X 


SSD 






X 



RUNNING 
READ UNSOL 



TAPE 
BEAD UNSOL 

* * 
X 



X - occurence possible 

♦ - IHPIPES STATE TBAKSITION 
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The timer segment (ICKHT) is used as a subroutine by the 
other segments and the TBG handler. There are three parts: 

Create timer queue element (ISTR) 

1. get TQE address from A-reg 

2. set T=1 in SIB 

3. JSB to timer enque routine 
<*. JMP TSTR>I 

Purge timer queue element (TERG) 

1. get TQE address fioi A-reg 

2. JSB to timer dequeue routine 

3. set T=0 

4. JMP TPRG,I 
Process timer expiration (T2 1P) 

1. locate SIB, set T-0 

2. If 1=1, queue a CCNTROL-DISABLE (=) purge) , exit. 

3. If E-1, queue a CONTROL-PURGE through the ' queue 
manager. Exit. 

U. If L=E-0, queue a CONTROL-ENABLE through the queue 

manager. Exit 

5. JMP TEXP,I 
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Calling Sequences: 

ICKH has four entry pcints. The primer entry, ICKHP, is 
entered from the dispatcher then vcrk is gueued for ICKH* The 
calling sequence is 

NOP switch lccaticn 

JSB ICKBP 

Exit is via: 

jhp .con. 

The I/O complete entry, ICKHC, is called by the dispatcher 
whenever an event completes en the interconnect kit* The calling 
sequence is: 

LDA 
LDB 
JMP ICKHC 

and it exits through: 

JMP .COB. 

A third entry point, ICKHI, is used, only during system startup. 
The calling seguence is: 

JSB ICKHI 

and it exits by 

JMP ICKHI, I 

The fourth entry point, ICKHT, is used for timer services* The 
calling sequence is: 

LDA TQE TQE address 

JSB ICKHT 

and exit is via 

JMP ICKHT, I 
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Called Routines: 

The interconnect kit handler uses the services of the queue 
manager, buffer manager, allccate/deallocate manager, and the TBG 
handler. The handler manages the interconnect kit through .IOC* 
and the ICK driver. 
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Local lata st£j£tj2£e£ 

Associated with every data stream is a block containing 
status and control information, buffer pointers, and a tiaer queue 
area. The stream information blocks (SIBs) are ordered by stream 
id number (0-31) into a streai information table (SI?)* Each 
block is 8 words long so that any SIB address can be built by the 
computation 

SIBadd=SITadd*8* (stream id) 

The SIB entries are defined as fellows: 

HOHD 1 STATUS INDICATORS 

15 14 13 12 11 10 9 8 7 6 5 4 1-0 

POICDWELZTURS 

P - purge flag 

*1 the SP has reguested all output be killed 
=0 no purge in progress 

- output flag 

*1 output from SE pending 
=0 no output pending 

1 - input flag 

*1 the SP is waiting for input 
=0 no input request pending 

C - enable flag 

=1 enable operation pending 
-0 no enable pending 

D - disable flag 

=1 disable operation pending 
=0 no disable pending 

W - special write flag 

*1 zero length write to terminal pending 
=0 no write pending 

E - ENTER flag 

=1 ENTER statement timing in progress 
*0 no ENTER statement timing active 

I - Logon flag 

*1 Phones timing in progress 
=0 no Phones timing in progress 
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Z - disable timing flag 

= 1 disable timing in progress 
=0 no disable tising active 

T - timer flag 

=1 timer element queued 

=0 timer element net queued 

- user activity flag 
s 1 user signed oc 
=0 no user active 

R - read activity 

=1 read active on ICK 
=0 no read active 

S - state flag 

=0 conversation state 
«1 running state 
=2 tape input state 

WORD 2 - BUFFER ACTIVIT* FLAGS 

5 4 3 2 10 
B2 B1 

B2 - buffer allocation flag 

=1 buffer is allocated (see BS2) 
=0 buffer 2 is available 

"B1 - buffer 1 allocation flag 
same as B2 definition 

WORD 3 - Buffer 1 Address 

15 

POINTER TO BUFFER #1 

WORD 4 - Buffer 2 Address 

15 

POINTER TO BUFFER #2 

WORDS 5-8 - System Timer Queue Element 

15 

5 TIHE INTERVAL IN 1/1 C ths OF SEC 

6 ADDRESS OF TIflER EXPIRATION PROCESSOR* 
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7 TBG DRIVER LINK WORD 

8 TBG DRIVER LINK WORD 

*ICKHT 

The queuing and control information required by the queue 
lanager, handlers, drivers, and .IOC. is contained in a set of 
buffer control words (BCW»s) appended as a prefix to each buffer. 
Descriptions are found under "Global data structures," Word 8 and 
Word 1 of this prefix are jointly defined by the interconnect bit 
and Multiplexor handlers for communication of status information. 
All other uses conform tc the descriptions under GLOBAL DATA 
STRUCTURES. 

Word 8 - Event Status 

Bit Usage 

15 inclusive OR of bits 1H-10 

14 record received with lost data error 
13 record received with parity error 

12 line connect 

11 line disconnect 

10 break character received 

8 last . operation indicator 

1=terminal output 

0=terminal input 

Word 1 - Buffer lype 

Bit Usage 

15 special zero length write to terminal or 
timed read completing 
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M ulti tlexcr Han dle ^ 



Functional descrj ^ion 



The multiplexor handler (MOXH) manages communications between 
those devices attached to the 12920A multiplexors and the 
interconnect kit .handler. Because of its close interelationship 
with ICKH and because of the nature of the physical device it 
controls, MOXH has some unique characteristics: 

1. Since the 12920A multiplexor is a single physical 
device which runs multiple logical devices, all 
communication must be specific to a logical device. 
For this reason, all communications directed to or 
emanating from MOXH must contain device indentif iers. 
This is true for both IOC and QM traffic. 

2. The logical devices . attached to the mux are 
bidirectional. Hew they are used is dictated by ICKH; 
therefore, all communications between MOXH and ICKH 
contain explicit directives on actions, to be performed. 

3. Each logical device (or data stream) is independent of 
every other data stream. Separate status and control 
information is maintained for each. 

4. Buffering is mataged by ICKH and all buffers are 
interlocked. MOXH disposes of empty buffers by queuing 
them to ICKH and is ignorant of all processing states 
as defined for ICKH. 
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As alluded to earlier the mux handler is comprised cf three 
segments; an initialization segment called at system startup,, a 
Primer section which processes work queued for the muz handler and 
an I/O complete section vhich processes I/O event complete 
notifications. Implicit tc the subsequent discussion of mux 
handler processing is the understanding that each data stream is 
separate and independent. 

The Primer section (HDXHP) processes all work queued for HUXH 
by other handlers. Work consists of data and/or control requests 
as defined by the buffer control words prefixing each queue entry. 
HOXHP processing proceeds as fellows: 

1. obtain queue entry from QM 

2. establish stream id and save 

3. obtain command code and process as follows: 

a. WHITE - issue WRITE .IOC. call to driver, and 
exit. 

b. BEAD - issue BEAD .IOC. call to driver, and exit. 

c. CONTBOL-PURGE - issue PURGE .IOC. call to driver, 
return buffer as a NOP, and exit. . 

d. CONTBOL-ENAELE - configure stream for auto-speed 
detect and issue ENABLE .IOC. call to driver, and 
exit. 

e. CONTBOL-DISABLE - issue DISABLE .IOC. call to 
driver, return buffer as NOP, and exit. 

f. ALLOCATED EUFFER - use as directed by the first 
ncn-zero entry in the Port Table (PTAB) and zero 
the entry. 

The I/O complete section (HOXHC) processes completed event 
and unsolicited event notifications. Notifications consist of a 
copy of the ICC parameter wcrd, and the queued request entry (see 
GLOBAL) MUXHC processing is as follows: 

1. establish stream id and save 
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2. if notice was solicited go to 3; else 

a. if line drop, acquire control buffer and queue 
event notification through QM, then exit 

b. if break received, acquire control buffer and 
queue notification through Qti, and exit* 

c. if unable tc obtain a control buffer, save event 
status in PlAB and exit, 

3. If the operatioc was purged, set CHD=0, queue the 
buffer, and exit 

4. Write coaplete - set CMD-0, queue the buffer, and exit 

5. Read coaplete - set CMD-1, save conpleticn status, 
queue the buffer and exit 

6. Enable coaplete -set CMD*1, indicate line connect, 
queue the buffer and exit 

7. Disable ccaplete - set CND s 0, queue the buffer and exit 

8. Purge ccaplete - set CHD»0, queue the buffer, and exit 

The initialization section (HOXHI) is entered at systea 
startup. Processing requirements are: 

1. obtain identif ica ticn for MUX and ICK handlers. 

2. issue CLEAR .IOC. call for all data streams 

3. exit 
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In ter facing 

calling sequences: 

MUXH consists of three segments, an Initialization section 

(MUXHI), a Primer section (MUXHP), and an I/O complete section 

(HUXHC). MUXHP is activated by the QM whenever another handler 

has queued work for MUXH, it is entered from the system dispatcher 
by 

NOP active gate set by QM 
JSB HUXHP 

The primer exits by a JKP .COM. 

MUXHC is entered from the system dispatcher for notification 
of completed events on auz devices or to inform the handler of 
unsolicited occurrences on the devices. The calling sequence is 

LDA IOC pcinter 

LDB buffer pointer/status word 

JMP HUXHC 

and the completed event section exits 

JMP .COM. 

The initialization section (MUXHI) is entered at system 
startup by 

JSB MUXHI 

and returns control via 

JMP MUXHI, I 

called routines: 

MUXH calls upon the queue manager (.GETQ,.PUTQ,S.SEEQ) and 
the services of .IOC. 
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k2°.al data structures 



Attached to each buffer queued to M03CH is a nine word prefix 
of control words. These BCB's as well as those mentioned above 
are described under "Global data structures* " Word 8 of the BCIs 
is jointly used by the multiplexor and interconnect kit handlers 
to communicate event status information* All other uses conform 
to the descriptions under "Global data structures." 



Word 8 



Event Status 



Bit 

15 

14 

13 

12 

11 

10 



Osage 

inclusive OH of bits 14-10 

record received with lost data error 

record received with parity error 

line connect 

line disconnect 

break character received 



A Port Table (PTAB) is maintained with a one-word entry for each 
port configured (the entries are in port number order). A non- 
zero entry indicates that ac allocated control buffer is expected 
for that port. The content of the entry is the event status which 
caused the buffer request. 
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I* Functional Specificatiors 

The multiplexer data interface driver provides an interface 
for input/output operations between an HP 21 00 computer and 
asynchronous devices attached tc the 12920A multiplexer* 

The multiplexer driver will handle up to two 12920A 
multiplexers simultaneously (a maximum of 32 I/O channels). 
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The following functions are available thru calls tc .IOC. 
fl&Siifill 3]|]2_f uj&c£i25 Operation 

99 9 Reserved 

01 99 R ead characters from the desig- 

nated channel into the designated 
buffer. Terminate on CR. 

J/1 1J& Reserved for future use. 



j?1 2JS E nabl e the designated channel; 

i.e. allow a user to dial up on 
the designated channel. Terainate 
when a user dials up. 



92 %9 Write the designated nuaber of 

characters from the designated 
buffer. Terminate at end cf 
buffer. 



92 29 Control the operation of the 

multiplexer by outputting the 
given parameter word. 



92 39 Dis ab le the designated channel 

Do not allow a user to dial up 
the designated channel. No 
further operations are allowed 
tc the channel until an Enable 
is executed. 



92 ^9 Purge the current read or 

write or both operation (s) 
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II. Calling Sequences 



General calling sequences following the form for. regular •IOC, 

calls: 



EXT 



.IOC. 



JSB 

OCT 

JSB or JHE 

DEF 

DEC or OCT 

(normal return) 



.IOC. 

function subf unction unit-reference 

reject address (error return) 

buffer address 

buffer length in plus bytes 



the fornat of word 2 is in general: (PVH '■ j* at all tiaes) 



15 
function 



1211 

subfunctics 



9 8 7 6 5 

P v M unit-reference 



Note: 



The queued versicn cf .IOC. requires each buffer to be 
prefixed with buffer control words. This is assumed to 
hold in the following description. Also note that if 
■ore than one nultiplexer is attached to the computer 
the "unit reference" is the select code of the first 
(lowest) nultiplexer. Buffer control word 5 is 
specified as follcws for all .IOC. calls,. 



BITS 6-7 
BITS 8 - 15 



reserved for PURGE call. 

channel number at which the coaaand is 

directed. 
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Head: 

JSB .IOC. 

OCT function subfunction unit reference 

JSB or JMP reject address (error return) 

DEE buffer address 

DEC or OCT buffer length in plus bytes 

function = J/1 
subfunction * pp 
unit reference = nn 

where nn is the unit reference of the multiplexer, 
buffer address » address of the area into which characters are 

read, 
buffer length = maximum number of characters to be read. 

Returns: If there is no error in the calling sequence and the 

read has been successfully ititiated the normal return is taken. 

If the reject address is taken then registers A and B contain 
pertinent information. 

15 14 13 8 7 10 

A-register = a equipment type status 
B-register « d • ZERO — C 

See the status IOC call for register A definations. 

d=1 The device driver is busy 

c>1 A DMA channel is not available 

d=c-0 The function or subfunction is not valid for this device 

Asynchronous return; when the read operation is terminated by the 
cccurance of a carriage return or seme unusual condition, a 
completed event notice is passed to .IOC, which then informs the 
user level program. 
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Status; (not currently supported) 
JSB .IOC. 

OCT function subf unction unit reference 

DEF buffer address 

DEC 1 

(normal return) 

function = |71 
subfunction * 10 
unit reference - nn 

Where nn is the unit reference of the multiplexer for which 
status is requested. If on is zero then system status is 
returned. 

Returns: Ho errors are possible. 

The contents of the A and B registers contain the status 
information. 

15 14 13 87 

A-register= a equipment type Status 

B-register = s transmission log 

a=0: The device is available; the previous operation is complete. 
a=1: The device is available; the previous operation complete but 

a transmission error has been detected. 
a-2: The device is not available for another request; a requested 

operation is in progress. 
a=3: Previous operation was purged. 

equipment type: These six bits indicate the device type 
The value is 77 
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Status 
flit 0=< 

Bit 1 



bit 



Bit 2» 

a 

Bit 3 = 

s 

Bit 4= 



'0 

A 

0: 
1: 

0: 

1: 

0: 

1: 

=0 

ransm 

perat 



definition 

A character was received 

A character was transmitted 

No characters lost en read operation 

One or more characters have been lost during the read 

operation 

No break detected during current operation 

A break character was received 

Diagnose node is not set 

Diagnose node is set 

The seeking bit is not set 

The seeking bit is set 



ission 
ion. 



leg is the positive count at the end of the 
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write; 

JSB 

OCT 

JSB or JHF 

DEF 

DEC or OCT 



.IOC, 

function subf unction 

reject address (error 

buffer address 

buffer length in plus bytes 



unit reference 
return) 



function = 92 
subfunction = 99 
unit reference = nn 

Where nn - is the unit reference of the multiplexer 
buffer address = address of the output buffer 

buffer length = the number cf characters to be transmitted to the 
designated channel 

Returns: If there is no error in the calling sequence and the' 
operation has been successfully initiated (queued IOC) the normal 
return is taken* If an errcr is detected in the calling sequence 
or the operation can't be initiated the reject exit is taken* 

Asynchronous return: When the vrite operation is conplete (buffer 
empty) or purged by the user .IOC* notifies the user level program 
by an entry in the completed event queue* 

NOTE: If a read command is active when a write command is passed 
to the driver, the read is purged before the write is initiated* 
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JSB .IOC. 

OCT function subfunction unit reference 

JSB or JMP reject address (error return) 

DEF buffer address 

DEC or OCT 1 (constant 1) 

(normal return) 

function =01 
subfunction » 20 
unit reference = nn 

Where nn is the unit reference of the multiplexer, 
buffer address = address of a cr.e word buffer 

Heturns: If there is no error in the calling sequence and the 
operation has been successfully initiated the normal exit is 
ta.fcen, otherwise the reject exit is taken. 

|s,ya.cfcronous Return: The enable is posted complete nhen a 
connection is established for the requested channel. The driver 
assumes a connection is established when either of tyo conditions 

1, Data set ready is asserted by the data communications 
equipment. 

2. k carriage return is received from the data terminal 
equipment. 

Sither of the above conditions causes an outstanding enable 
operation to be completed. Condition one (1) allows proper 
operation over dialup or dedicated lines with modems. Condition 
two (2) allows operation with hardwired (three wire) lines. 

flOTE: Be sure that all current operations are complete before 
issuing the enable. It is best to precede the enable by a disable 
or purge operation. The current driver implementation purges all 
oparations before processing the enable request. Further note 
that not a].l terminals will ££!LEate oyer three aire (send, 
receive, "signal ground) circuits without special jumpers attached 
to the connector at the data terminal end; some terminals require 
the presence of data set ready, and/or clear to send and/or 
carrier detect. 
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C o n t£ o 1 : 

JSB .IOC, 

OCT function subf unction unit reference 

JSB or JME reject address 

DEF buffer address 

DEC or OCT 1 (constant 1) 

(normal return) 

function = 02 
subf unction = 20 
unit reference = nn 

Where nn is the unit reference of the multiplexer. 

Returns: Like the write call* 

Operation: The parameter word at the given buffer address is 
output to the designated channel. 

Parameter vord definition: 

Bit 15 ■= 1 must be set to one 

Bit 14 * output paraieters to receive channel „ 

If Bit 14 = 0, then the following definitions hold: 

Bit 13 * disable receive interrupts 

Bit 13=1 enable receive interrupts 

Bit 12 = do not Echo received characters 

Bit 12=1 Echo received characters 

Bit 11=0 disable diagnose logic 

Bit 11=1 enable diagnose logic 

Bit 14 = 1 

If Bit 14 = ^ f then the following definitions held: 

Bit 13 = disable transmit interrupts 

Bit 13=1 enable transmit interrupts 

Bit 12 = generate even parity for 8 bit ASCII 

Bit 12 = 1 generate odd parity for 8 bit ASCII 

Bit 11 = disable diagnose logic 

Bit 11 = 1 enable diagnose logic 

Regardless of the setting cf bit 14 the following definitions 

hold: 

Bits 8-10 (character length - 5) MOD (12) 
Bits 0-7 (14,400/Baud rate) - 1 

For a control function tfce channel number (Bits 8-15 cf Buffer 
prefix word 5) have a special meaning* 
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Bit 13 « 1 diagnostic channel configuration 
Bit 14 « C first mux 
Bit 14=1 second mux 
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Di sable: 

"J SB .IOC. 

OCT function subfunction unit reference 

JSB or JMP reject address 

DEF buffer address 

DEC or OCT 1 (corstant 1) 
(normal return) 

function = 02 
subfunction « 30 
unit reference * nn 

Where nn is the unit reference of the multiplexer, 
buffer address = address of a one vord buffer. 

Returns: If there is no error in the calling sequence and the 
operation has been successfully completed the normal exit is 
taken. Otherwise the reject exit is taken* 

NOTE: Disable vill purge all outstanding read and write 
operations before being initiated. The data set control interface 
for the requested multiplexer channel is set to cause a "ring 
forever" condition; this can only be cleared by an enable being 
issued to the same multiplexer channel. 
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JSB .IOC. 

OCT function subfunction unit reference 

JSB or JMP reject address 

DEf buffer address 

DEC or OCT 1 (constant 1) 

(normal return) 

function = 02 
subfunction = *j£ 
unit reference = nn 

Where nn is the unit reference of the (first) multiplexer, 
buffer address = address of a null (p length) buffer. 
Only the buffer control words (1-5) are passed to r and used by the 
driver. The word at buffer address-1 contains the following 
information: 

BITS: 7 6 

Reserved 

1 Purge current read operation 

1 Purge current write operation 

1 1 Purge current read and write operations 

As usual, bits 8-15 contain the channel number on which the purge 
operation is to take place. 
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III. Unsolicited Event Notifications 

There are two conditions which can cause an unsolicited event 
notice to be passed from the 12920 A driver to the tase level 
program. In both cases pertinent infornation is returned in A and 
B. 

The first is a "line drop* or * connection broken" on the TP 
line. 

A register 

Bits 0-5 = unit reference number of the Multiplexer 
Bits 6-11 = stream identifier (terminal number) 

B register 

Bits 0-15 = Zero 

The second unsolicited return is caused by the detection of 
an unusual conditicn during a data transmission* 

A register 

Bits 0-5 unit reference number of the multiplexer 
Bits 6-11 stream identifier (terminal number) 

B register 

Bit 0=0 current operation is a read 

Bit 0=1 current operation is a write 

Bit 1=0 no characters lost 

Bit 1=1 one or mere characters lost during current 

operation 

Bit 2=0 no break detected 

Bit 2=1 break detected 

Bit 3=0 diagnose disabled 

Bit 3=1 diagnose enabled 
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IV, Design Overview 

Di51 T&e 12920 A mult i£lexer, driver 

The multiplexer driver provides input, output and data 
link control facilities for asynchronous devices attached to 
the 12920A multiplexer. The driver is modular in design and 
provides an interface between the 12920A hardware and Queued 
.IOC. 

The driver is cognizant of the communication line 
status at all times. All lines must be enabled before any 
read or write operation is issued. When the link is 
established notification is passed to the user level program. 
When the operation (raad/write) is completed notification is 
passed to the user level. 

.gasman assumptions 

The software driver for the 12920A multiplexer assumes 
the existence of the HP2000 ACCESS I/O processor microcode. 

Since the drivei is able to handle more than one 
multiplexer the select codes must be assigned as follows: 
first mux lower data select code; first mux upper data select 
code, first mux data set control board select code, second 
mux lower data select code, second mux upper data select 
code, secon.d mux data set ccntrol board select code. This 
restriction is imposed because there is only one equipment 
table (EQT) regardless of the number of multiplexers attached 
to the system. The driver also .assumes that these select 
codes are consecutive. 

D esign summ ary 

Although the multiplexer is physically a single I/O 
dsvice filling three I/C slots in the 2100 CPO, logically it 
must be viewed as 16 full duplex I/O channels. This implies 
that the driver must maintain information for each of the 16 
channels attached to each multiplexer. This information is 
contained in Logical Unit Tables (LUT's) internal to the 
driver. Each LOT is coiposed of three sections, one for read 
commands, one for write commands, and one for terminal 
configuration. The structure of the LUT is outlined below 
and displayed in Table 1. 

Like all BCS drivers the mux driver has an initiator 
(D.51) and a continuatcr section (1.51). The initiator 
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section is responsible for converting a requested operation 
into the appropriate actions. It also queues reguests for 
channels which are busy vhen the request is aade. There is a 
read queue and a write gueue associated with each LUT. The 
continuator section is primarily an interrupt handler and 
event complete processor* 

Key. a.laor.i^B' descriptions 

Aatoaatj^c speed de tect ion — The aultiplexer driver software 
contains logic to detenine at what baud rate (speed) an 
attached terainal is transmitting characters. The driver 
assumes the transmit speed is the sane as the receive speed. 
Speed detection is facilitated by the hardware features of 
the aultiplexer interface. Each interface has 16 full duplex 
input/output channels. Each of .the channels is capable of 
operating independently of the others at any baud rate fron 
about 50 to 2400 bits per second. In addition to the 16 aain 
channels there are 5 diagnostic channels. By setting the 
diagnose bit in a aain channel receive parameter, the 5 
diagnostic channels can be tied to the aain channel. Each of 
the diagnostic channels can be configured to receive at a 
baud rate different froa the main channel and the other 
diagnostic channels. Speed detection operates as follows. 
The aain channel is configured to receive characters at 2400 
baud* The five diagnostic channels are configured to receive 
at Y200, 600, 300, 150, and 110 baud respectively. The user 
at his terminal strikes a known key (in the case of this 
driver a carriage return which is an octal 15). The aain 
channel receiving at the 2400 baud rate interrupts before any 
associated diagnostic channels do. The software exaaines the 
received character. If it is a carriage return, the wain 
channel is operating at the correct speed (2400 baud), and 
the only configuration that need be done is to turn off the 
diagnose bit in the receive channel parameter and turn off 
the speed detect bit ir the user status word. If a carriage 
return is not seen at. 2400 baud, the driver exits and awaits 
diagnostic channel interrupts. Eventually, the diagnostic 
channel configured for the same speed as the transmitting 
terminal will interrupt with a carriage return as the 
received character. The aain channel is then reconfigured 
(froa 2400 baud) to the rate associated with the diagnostic 
channel which had the interrupt; again the speed detect bit 
in the user status word is turned off. In all cases, 
whenever the correct speed is sensed (carriage return seen), 
the "parity detection in progress" bit of the user status 
word is set. This bit is used in the autoaatic parity 
detection algorithm. 
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Speed sensing for 2741 type terminals is handled in a 
slightly different fashion. Since 2741 terminals operate at 
134.5 baud with 6 bit characters, their carriage return 
character would not te recognized using the algorithm 
described above. Every 2741 emits a special line control 
character, called a circle C, after each carriage return. 
Furthermore, this circle C is seen as an octal 100 when 
received at 300 baud and as an octal 174 when received at 150 
baud. When the diagnostic channel which is configured to 
receive at 300 baud (channel 18) receives an octal 100, a 
specific flag ("selectric possibility" flag) is set. The 
next diagnostic channel interrupt (at 150 baud) will be an 
octal 174 if the terminal is indeed a selectric. If the 
octal 174 is not received at 150 baud, the "possibility" flag 
is reset. 

A^to ma ^jfC ierjninal parity detec tion -- Automatic parity 
determination is accomplished in connection with automatic 
speed detection. Whet speed is correctly determined, two 
things are done. First, the "parity detection in progress" 
bit is turned on in the user status word. This bit tells the 
driver that the next character to accept must be a line feed 
(octal 12); all other characters are ignored. Secondly, the 
parity (bit 7) of the correctly received carriage return is 
saved in the channel status word, when the waited for line 
feed is received, its parity (bit 7) is also recorded in the 
channel status word. since carriage return and line feed 
have opposite parity sense, the parity with which the 
transmitting terminal is operating can be determined as shown 
in the following table: 

Received parity of Terminal Farity 

Ncne - space for parity bit 

Odd parity 

E ve n pa ri t y 

None - mark for parity bit 

Note: An underlying assumption in both automatic speed and 
parity detection is that the carriage return and line feed 
are received without ecrcr. If speed and/or parity are 
improperly determined due to an error, the user will not be 
able to correctly log en the system. In this case, his port 
will be disabled and re-enabled after the PHONES parameter 
time limit has expired; always less then 255 seconds. 
Therefore, a port cannot be locked out indefinitely because 
of incorrect speed/parity determination. 
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H a-tor fodul e Eglat^onsh^ps 

The aodule relationships are indicated in Figure 1* 
Data and control flow aie indicated in the sane figure* The 
continuatcr section of the driver follows the philosophy of 
the 2000F IOP multiplexer driver quite closely; indeed, auch 
of the 2000F code for selectric processing remains intact. 
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V. Design Structures 

lilS Logical Dnit Table 

The logical urit table (LOT) contains all the 
information essential tc the operation of the driver. The 
LUT contents are accessed or modified by all »odules in the 
driver. There is one LOT per multiplexer channel and each 
LOT has a read section, a write section, and a terminal 
configuration section. Table 1 shows the contents cf an LOT. 
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TABLE 1 
LOT CONTENTS 



READ^SE CTj CON 



RBFAD Read buffer address 

RBYCT Read byte ccunt 

RRCNT Read request count 

RBYAD Read byte address 

BQHED Read queue head 

RQEND Read queue tail 
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WBFAD Write buffer address 

WBYCT Write byte count 

HRCNT Write request count 

WBYAD Write byte address 

WQHED Write queue head 

WQEND * Write queue tail 



^ E [ RMINAL i „CONFIG i URAJIC N., SJCTI C N 

TYPE Terminal tyEe 

CDLY,LFDLY Carriage return, line feed delay 

ECNT Delay counter 

STAT User status word 

STAT2 Port status word 

PPRrt Data set control board parameter 

RPRM Receive channel parameter 

TPRM Transmit channel parameter 

SCNT CR-LF delay counter for selec tries 

■HMffR QUEUE .E^EHEjjT 

OCT 24 20 clock ticks (2 seconds) 

DEF DSTE,I Exit routine for timer expiration 
OCT 0,0 Timer queue link and save word 

OCT nn Port number in bits 13-10 

(Bit 15 set if 2nd multiplexer) 
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LOT BIT DEFINITIONS 



STAT - OSER STATUS WORD 

10000 User is in tape mode 

1 Speed detect in progxess (not detected) 

4 Control I was entered 

10 Reserved 

20 Line drop timing in progress 

40 Line feed needed for tape mode prompt 

100 Special write active (/CRLF) using receive buffer 

200 User is in Run node 

400 An operation is active 

40000 Input is not allowed 

100000 Purge in progress (ignore interrupts) 

4000 X-OFF was input from terminet 

20000 Parity detection is in progress 

2000 Input configuration seeded (Reserved for future use) 

20000 264X ENQ transmitted 

1000 Preceding input was INC 
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TATOS WORD 

acter was received/transmitted 

acteri was lost (input) 

K (input) was detected 

rt is in diagnose mode 

eking bit is set 

ty error (input) has occurred 

annel requires parity 

1 parity (odd=1, even=0) 

of carriage return 

of line feed 

type subtype 



TYPE - TERMINAL TYPE PLUS CTKEFS 

2 Code determined (EBCDIC or CALL/360) 

4 Upper case mode 

10 "CENT" character 

20 "CENTC" character 

40 "CR M bit (used for output only) 

100 Control X was entered 

200 Circle c sent 

400 Circle d (Psuedo) Transmit interrupt 

1000 SYNC w n ■ » 
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2000 Space » » « 

4000 Space w " M 

10000 Space . " " " 



PPBM - PHONES PARAMETER WORD (See ERS fcr definition) 
BPRM - RECEIVE PARAMETER WORD (See ERS for definition) 
TPRM - TRANSMIT PARAMETER WOfD (See ERS for definition) 
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VI. Hajor Functional nodules 

The mux driver consists of five major modules D.51, 1.51, 
A. 51, T.51, P. 51, the initiator section, the continuator section 
(driver contrcl) , the appendage section, telephone line control, 
and power fail/restart section. Each section has specific 
functions distinct from each of the others. 

£*£! The, Ini tiato r Sec ticn 

The initiator section D.51 receives control frcm .IOC. 

as a result of a user call. D.51 checks the requested device 

to see if it is operable and the user requested operation and 

user supplied parameters are valid* If these conditions are 
satisfied, D.51 queues the request for processing. Purge and 

control requests are net queued; they are executed 
immediately. 

In the event the user reguest can't be satisfied, the B 
register indicates the zeason: 

B= 100000 Ths device is busy or inoperable. 
B= 000000 The request is not legal. 

In these twe cases the A register is set to 1. If the 

reguest was successfully initiated (this nay mean 

successfully queued) the A register is zero and the B 
register contents are urdefined. 

I f 51 The C ontinua tor Sec tion 

The continuator section 1.51 receives control whenever 
one of the multiplexers attached to the IOP causes an 
interrupt, or it may be entered directly by a call from D.51 
to start an operation. 

Upon receiving control 1.51 saves A, B, and E. Next 
1.51 determines whether the cause of the interrupt derives 
from a solicited request (read or write) on an unsolicited 
(asynchronous) event (i.e., break key struck). If the 
interrupt is due to a read/write request a character is 
appended to/removed frcm the buffer associated with the 
current operation (s) for the interrupting channel. Note that 
the channel number (0-15) must be associated with the correct 
multiplexer (0 or 1) tc arrive at a user "stream number** (0- 
31) • The appropriate cede and/or protocol conversions are 
done on a per -character basis. 
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Interruptions due to unsolicited events are handled in 
a special way. Notification is returned to the user level 
via an unsolicited entry in the coapleted events queue of 
• IOC. Included in the notification is the cause cf the 
unsolicited interrupt. Certain unsolicited interrupts are 
transparent to the user level program. The occurrence of any 
of these special events causes driver dependent actions to 
occur. An example is the backspace character* The user 
level program is not informed of the receipt of a BS 
character; rather the current byte pointer is decremented and 
normal processing continues. 

The continuator secticn is also responsible for notifying 
•IOC. when operations are complete and for initiating the 
next queued request (if acy). 

JUJL1 IkS App endag e Con tr ol Section 

The Appendage Ccntrcl section A. 51 receives explicit 
control from the ICK driver via a . JSB instruction. The 
purpose of A. 51 is tc respond to certain system processor 
initiated requests for information which is contained in the 
LOT for a given channel. A. 51 decodes the request, obtains 
and formats the data frcm the LUT, and returns tc the ICK 
driver. 

It is desirable to < make this code as logically 
independent of the mux driver as possible. 

T» 51 T he Tel ecom munica tien s Li ne C ont rol S ection 

The Telecommunications line control secticn T.51 is 
responsible for monitoring the status of user connections 
(phone lines or hardwired) to the IOP. when a change in any 
line status is detected, the user level program is made aware 
of the change via an unsolicited entry in the completed event 
queue of .IOC. The two possible line states are "connection 
established" and "connection broken." T.51 will time short 
line drops to determine if the line is permanently or 
temporarily down. Any line drop of 2.0 seconds or greater 
.duration on an established line will cause a "connection 
broken" to be passed to the user level program. 

T.51 will access the LUT 1 s for the channel and modify 
certain status information. When an initial connection is 
established T.51 tells the driver control section, 1.51, to 
begin auto-speed detect for the newly connected channel. 
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P.51 The Power. Fai l /R estart Control Secti on, 

P. 5 V the power fail recovery section of the driver 
receives control from D.04 after pcwer is restored to the CPU 
following a power failure* P. 51 is responsible for restoring 
the multiplexer interface and data set control interface 
cards to the status they were in when the power failure 
occurred* In addition to restoring the device flag and 
control status, the proper input and output channel 
parameters roust be restored in the multiplexer interface 
memory. The dataset ccntrcl board interface parameters must 
also be restored, and any interruptions pending fcr either 
the multiplexers or data set control interfaces must be 
handled appropriately. Any multiplexer channels which were 
actively engaged in output at power fail time are restarted 
following the last character praviously output. Any 
multiplexer channels which were in the input wait state have 
their receive operations terminated with a character lost 
indication; this allows the BASIC program to reissue the 
input operation. 
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SECTION I 
OVERVIEW 



SECTION IV 
NON-SHAREABLE DEVICES 



'KwLFTT-PACKARD <>000 SiSrF.tt I/O PROCESSOR 



Nt_)N-SHAPEABLE DEV ICFS 



CONTENTS 



1. 


0.6 3 


2. 


ASFH 


3. 


CPU . 


4. 


D.l 1 


S. 


LPH 


6. 


U.12 


7. 


PPH 


d. 


U . 1 3 


9. 


PRO/CRH 


10. 


I>. J 4 


11. 


RPH 


1 'I. 


D . 3 4 


1 *. 


LHi 


14. 


U. S3 



JNTF.RCONfifc.CT KIT DRIVER (ASCII FILF.S) 

ASCII FILE HANDLER 

CARD REAPER HANDLER 

CARD RFAPF.K DRIVER 

1,1 MK PRINTER HANDLER 

LINE PRINTER DRIVER 

PAPER TAPE PUNCH HANDLER 

PAPER TAPE PUNCH DRIVER 

PAPER TAPh HEADER HANDLER 

PHllTH READER DRIVER 
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* D.63 is the ASCII KILES portion ot the interconnect 
*■ Kit driver. The documentation on this module is broken 

* into the following sections: 



I. UNIT CONTROL TABLE 

II. SYSTEM PROCESSOR REQUESTS 

111. IOC REQUESTS 

IV. UNSOLICITED EVENTS 

V. BCW USAGE 

VI. IUP - SP PROTOCAL 
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* I. UNIT CONTROL TABLF (OCT) 

* 

* IOPC builds a table for D.o3 called the unit 

* control taole. The UCT contains one 6 word entry tor 

* each Ascli File Device configured into the 10P. Each 

* 6 word entry Is called a unit control block CUCB). A 

* UCB consists of the following elements: 
* 

* 1. ■ UOHEO head of request queue for this device 

* 

* 2. UFOOT tail of request queue tor this device 

* 

* 3. USTAT iocical status of the device (relative to 

* SP and ASFH) 

* 

* BIT 15 device online 

* set when ADV received 

* cleared when RDV, KDU received 

* BIT 14 WUU - WAKE USER UP MUST BE SENT 

* set when RDV, ALB, XPB rejected 

* set wnen STR received 

* cleared wnen WUU sent or KDU received 

* BIT 13 RDV - RELEASE DEVICE RECEIVED 

* set when RDV first received 

* cleared when RDV finaliv acceoted 

* BIT 12 UNIT TYPE 

* set up by IOPC and never modified 

* =0 normal (real) device 

* =1 oseudo device 

* BIT 11 ALB/XRB UNSOLICITED EVENT FLAG 

* set wnen an allocate buffer (ALB) or 

* transfer input puffer (XRB) unsolicited 

* event is sent to the Ascii File Handler 

* cleareo when a read or write nutter 

* arrives at the driver as a result of 

* the unsolicited event 

* BIT 1 0-0 NOT USED 
* 

* 4. unijm tsb loqical unit niimner 

* 

* 5. UBLEN butter lenqth 
* 

* b. UDSTS physical device status 

* -3 RJE not ready 

* -2 EOF read 

* -1 no buffer available 

* . device ready 

* 1 device not. ready 

* 2 device error 

* 3 attention needed 

* 4 read/write failure 
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* .II, REQUESTS FROM" SYSTEM. PROCESSOR 

* 1* ADV - Allocate Device 
* 

* The system processor sends ADV when a BASIC 

* program has assigned an Ascii File Device. ADV 

* will eventually get passed to the device as a 

* start command. Any preparation at tne device driver 
■* level should be done at this time. 

* 

* D.63 always accepts this command. An unsolicited 

* event is put on the CRO for the ASFH. The online bit 

* is set in the unit status (USTAT). 

* 

* 2. XRB - Transfer Input Buffer 

* The system processor sends this command when 

* it wants to have data read from a device. 
* 

* A check is first made of the pending reguest 

* queue for this device. 

* If a write to the SP for the device is pending, 

* an IOP to SP transfer of the data is done via DMA. 

* . . 

* , If a write/control for the device is pending, it 

* is executed. A check is then made of the newly 

* updated device status (UDSTS). If the device status 

* . is good (zero), we go back to the oeginning and 

* check tor more pending requests. If the status is 

* bad, the command is rejected by sending the bad 

* status across the receive channel. If the bad 

* status was minus three CRJF not ready), no other 

* processing takes place. For all other device 

* errors, WUU is set in the unit status (USTAT). 

* If a read from the SP for the device is pending, 

* it is forced to completion and processing continues 

* as if there was no write gueued. 
* 

* If there is not a write to the SP queued, the 

* device status (UDSTS) is checked. If the status 

* is bad, the same bad status processing described 

* previously for write/control is invoked. If the 

* status is good, an XRB unsolicited eventis sent 

* to the ASFH and the XRB/ALB bit is set in the unit 

* status. The SP command is then rejected by sending 

* a minus three across the receive channel for pseudo 

* devices, and a minus one across for real devices. 

* If the device is real, the wUU bit in the unit 

* status is also set. 
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ALB - Allocate Buffer 

The system processor, sends this command when 
it has data to be written to the specified device. 

A check is first made of the pendinq reqest 
queue for the device. 

Jf a read from the SP for the device is pending, 
an SP to IQP data transfer is done via DMA. 

If a write/control for the device is pending, 
it is executed. A check is then made of the newly 
updated device status (UDSTS). If the device status 
is good Czero), we go back to the beginning and look 
for more pending requests. If the status is bad, the 
command is rejected by sending the bad status across 
the receive channel. If the bad status was minus 
three (RJE not ready), no other processing takes 
place. For all other device errors, WUU is set 
in the unit status (USTAT). 

If a write to the SP is queued, it is forced 
to completion and processing continues as if there 
were no read queued. 

If there is no read queued, the device status 
is checked. It the status is bad, the same bad status 
processing descrioed previously for write/control is 
invoked. if the status is good, an ALB unsolicited 
event is sent ot the ASFH and the XRB/ALB bit is set 
in the; unit status. The SP command is then rejected 
by sending a minus three across the receive channel 
for pseudo devices, and a minus one across tor real 
devices. It the device is real, the WUU bit in the 
unit status is also set. 

PCF - Perform Control Function 

The SP sends this command when it executes a 
CTL function in a BASIC program. 



The device status (UDSTS) is checked. If the 
status is bad, the command is rejected by sending the 
bad status across the receive channel. If the bad 
status is minus three (RJE not ready), no other 
processing occurs. For all other device errors, 
WUU is set in the unit status (USTAT). 
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.♦ If the device status is good, the command is 

* accepted by sending zero across the receive channel 

* and the a PCF unsolicited event is sent to the ASFH. 

* The control function to be performed is included in 

* the unsolicited event data sent. The device status 

* is then set to minus three for pseudo devices and 

* minus one for real devices. The ASFH will later 

* send a write/control down for the device to clear 

* this status, 
* 

* 5. STR - Start Timed Retries 
* 

* The SP eventually sends this command when the 

* previous SP request was rejected due to a device 

* error. It tells the 10P to periodically retry the 

* current I/O request until the device comes up, 

* A STR unsolicited event is sent to the ASFH 

* and the WUU bit is set in the unit status (USTAT), 

* 

* 6. RDV - Release Device 

* The SP sends this command when it is de-assigning 

* the device from the current user, 
* 

* First, the request queue for the device is purged. 

* Purging is described in the lOC^equests section of this 

* document. 
* 

* For Dseudo devices, the command is always accepted 

* and an RDV unsolicited event is always sent to the ASFH. 

* For real devices, processing differs. The first 

* time the command is received, it is always rejected, a 

* RDV unsolicited event is sent to the ASFH, and RDV and 

* WUU are set in the unit status (USTAT) • On succeeding 

* RDV*s, no unsolicited event is presented, the command 

* is rejected if the device is down (UDSTS # 0) and accept- 

* ed if the device is up. 
♦ 

* 7. KDO - Kill Device Output 
* 

* The System Processor sends this command when it is 

* ' aborting the current user of the specified device. 
* ' 

* The device request queue for the device is first 

* purged. Purging is described in the IOC requests section 

* of this document. A purge unsolicited event is then 

* sent to the ASFH and then both the device status (UDSTS) 

* and unit status (USTAT) are .cleared. 
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A *■ rite requests dn 1(.;P to m> transfer for a 
device, 

\ write request is mdie as h result ot the .SP 
sending Xkh tor the device.. the same processing is 
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*. 4. Write/Control 

♦ 

* A ^rite/control requests the device status (UDSTS) 

* in the UCB be updated to the value specified, 
* 

* The buffer is queued on the request queue in the 

*' UCB tor the device. Actual execution of write/controls 

* Cie. actual updating of UDSTS) does not happen when the 

* request is queued, write controls are executed on 

* reception of PCF, ALB, and XRB commands from the system 

* processor* and during purge processing. See the des- 

* cription of tne related routine for details. 

* • 

* 5. Purge 
* 

* A purge requests the clearing of all requests from 

* tne specified devices request queue. 

* 

* Besides being executed as a result of an IOC call, 

* the Purge processor is also called by the kdo and RDV 

* processing routines. 
* 

* Purged status is stuffed in D.63's EOT status word. 

* Each existing entry on the request queue for the device 

* is dequeued. Any write/Controls are executed. Other 

* operations are placed on the CRQ via .BUFR. They will be 

* oe marked as purged py .BUFR because of the 

* purge EQT status. When all operations have been purged, 

* the EOT status is restored. 
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TV. UNSHLIClThl) £VK\TS 



Unsolicited event notices from D.63 *ill give tne 
foilowinq i ni ornuit ion. 



A Keyister 

Bits 15-12 
Hits 11-fr 
Bits 5-0 



Not Used 

TSR Loq-icai Unit Number for the device 

IOC Unit Keference Number of ICK for Ascii File 



B Keaister 



ALW tilt 

bits 1^-1 

KDM Bit 1 

XWB Kits J-? 

ALB Bit i 

PCK Hits 15-8 
Hit 4 

Pi)V Hit 5 

STH Bit b 



Set 

Ne'jritive butter l< j n'ith for device, 

witnout sign nit 
Set (.octal 2) 

set (octal 14) 

Set (octal 10) 

Control Information 
Set 

.Set (octal 40) 

Set -(octal 100) 
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V. BO USAGE 



Although there are nine BCW words prefixing each buffer 
only the last five are considered at the IOC/Driver level. 
Furthermore, since 0.63 is a self-queing driver handling 
many possible streams, some tnings are handled differently 
than normal. IOC does not set up the BCW's before calling 
the driver - the driver does that itself. Also, before 
calling .BUFR, the driver must set up the DRQ and transmis- 
sion log in the EOT with information that is relevant to 
the completing stream. 



WORD 1 



WORD 
WORD 
WORD 



WORD 1 
WORD 2 
WORD 3 
WORD 4 
WORD 5 



BCW'S - INCOMING BUFFERS 



(BCW 
(BCW 
(BCW 
(BCW 



5) 
b) 
7) 
8) 



WORD 5 (BCW 9) 



Queuing word 
IOC request 
Request length 
Device status on 

Write/Controls 
TSB LU * in left 

byte 



BCW'S - OUTGOING BUFFERS 



(BCW 
(8CW 
(BCW 
(BCW 
(BCw 



5) 
6) 
7) 
8) 
9) 



Queuing word 
IOC request 
Transmission log 
Status 

TSB LU ¥ in left 
oyte 



Set up by driver 
Set up by driver 
Set up by driver 
Set up at handler 

Set up at handler 



Set up by .BUFR 
As above 
Set up by .BUFR 
Set up by .BUFR 
As above 



(CRQ) 
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Vt. IUP/SP PRUTUCAl, 



* For every Ascii File Device related command the SP sends 

* tne IDP qives back a response across its WKCKIvt! channel, 

* Following are two ^tables listing the IOP responses and 

* expected SP action as a result. The tirst table covers 

* the user not usinq IF ERROR, The second covers the user 

* usina IF fcRROR. 



RiP/SP PRUTOCAL - MJWMAL 



response 
-J 

-2 

-1 



1 

2 
3 



MF,AN I NG 

h.JK not ready 

KOF 

Record not ready 

Command accepted 
Device Not Ready 
Device Frror 
Attention \eeded 



FXPLCTKD SP ACTION* 

Iry aqain later (SP dequeues 
and then requeues the guy) 

Release Device CRDV) 

Swap cuy out, requeue when IOP 
sends WaKe User Up (WUU) 

Continue processing 

Send Start Timed Retries (SIR) 

Send Start Ti'ned Retries (STR) 

Send Start limed Retries when 
operator Awakes device 



Reaa/^rite Failure Send Kill Device output (KDD) 



* hesides the specified rxpected action, a KDO may 
cone across at any tine if the user hits break. 
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* IOP/SP PROTOCAL - IF ERROR 

* RESPONSE MEANING EXPECTED SP ACTION* 

* 

* -3 rje not ready Try again later (user can 

* do other things and retry 

* the I/O later in his program) 
* 

* -2 EOF Release Device (RDV) 

* -1 Record not ready Swap guy out, regueue when IOP 

* sends wafce user Up (WUU) 

* 

* Command accepted Continue orocessing 

* 

* 1 Device Not Ready Send Start Timed Retries if the 

* user retries the I/O, send 

* Kill Device Outut if the user 

* de-assigns the Ascii File 
» ■ • 

* 2 Device Failure Same as Device Not Ready 
* 

* 3 Attention Needed Same as Device Not Ready 

* 4 Read/write Failure Same as Device Not Ready 

* 

* * Besides the specified expected action, a KDO may 

* come across at any time it the user hits break. 
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ASCII File Handler 

Functional descri pti on 

The ASCII file handler coordinates communication between the 
System Processor (SP) . and the handlers for those devices 
designated as ASCII files en the HP2000 ACCESS system. Like the 
interconnect kit, the ASCII file handler will support multiple 
data streams (up to 64) through a single physical device* It is 
to be understood that individual streams are independent of one 
another. ASFH functions both as a level 2 and a level 3 handler, 
dependent upon th-j characteristics of the particular data strea.m« 
Therefore, it my acquire buffers which are in effect controlled 
by another handle?: (ASFH=level 3) or it may direct another handler 
to acquire buffers which are controlled by ASFH (ASFH=level 2)* 

The handler maintains control and status information for each 
data stream (see Local data structures) as well as embedding the 
control information in the Buffer Control Words (BCH) (see Global 
data structures). Buffering and processing techniques are 
determined by the device class as returned by the 
Allocation/Deallocation manage*. Buffering is generalized to n- 
levels where n is determined by the device class. Ail buffers 
will be dedicated for the duration of activity on the device. 

The handler oust respond to a number of events, both 
scheduled and unsolicited, which emanate from the SP. In addition 
it will be served fcj j a single gueue through which it receives work 
from other handlers. 

The following unsolicited notifications occur: 

1. Perform Control Function (PCF) - carry out the 
specified control function on the indicated device. 

2. Allocate Device (ADV) - the indicated device and data 
stream should be initialized. This may imply 
generating a start directive to another handler or 
acquiring and dispatching buffers. 

3. Release Device (PDV) - the indicated device and data 
stream should be deactivated. This implies generating 
a stop directive tc another handler. 

4. Allocate Buffer (ALE) - a buffer is required for data 
from the SP on the indicated device. 
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5. Transfer Inp.ut Bcffer (XHB) - a record for transfer to 
the SP is required frcn the indicated device. 

6. Kill Device Output (KDO) - all operations on the 
indicated device and data streaa should be purged 
(implies RDV) . 

Scheduled event notifications occur in response to READ, WRITE, 
and WRITE/CONTBOL requests made to the driver. 

Queue entries direct the ASCII File Handler to perform work 
at the request of other handlers in the system. The type of 
processing will be determined by the Buffer Control Words (see BCW 
in Global data structures). Allowable indicators and their 
meanings are: 

1. Mo operation - an empty buffer is being returned for 
reuse. 

Write * a full bcffer is available for transfer to the 
SP. 

Read - for level 3 devices a request for data frcm the 
SP has been made 

Stop - an end of file condition has been reached on an 
I/O device. 

5. Error - a device error has occurred. 

6. Allocated buffer - a previously requested buffer has 
become available. 

Start - this oily applies to level 3 devices and 
implies that stream is now available for use 

Likewise the ASCII File Handler queues work to other handlers in 
the system and specifies processing through the BCW^s. Valid 
queue entry types are: 



1. 
2. 

3. 



Write - output the data to the I/O device. 

Read - input data from the I/O device and send to the 
ASCII File Handler. 



Start 
device. 



perfori necessary initialization for the 
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4. Purge - purge all current operations on the device* 

5« Control - a control request (device specific) is being 

nade of tte device. 

6. Stop - perform necessary functions to deactivate the 

streaa 
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The ASCII Pile Handler (ASFH) is comprised of three sections. 
The initialization section, ASFHI; the I/O complete section, 
ASFHC; and the priier secticc, ASFHP. 

The initialization section is entered at system startup time 
(i.e. IOP load) and at systei INIT tine (i.e., SP ready). At 
startup time ASFHI must: 

1. Configure all ICC calls vith the logical unit number 
for ASCII files. 

2. Do a FIND on all logical units to obtain Q names and 
device types to complete the SIB entries. 

3. Exit to caller. 

At system INIT time ASFHI is entered so that it can: 

1. Purge all device gueues that are not idle and mark them 
as idle. 

2. Purge its own queue and empty it, returning any buffers 
to the buffer manager. 

3. Exit to caller. 

The primer section, ASFHP, is activated when an entry exists 
in the queue for ASFH. Processing consists of: 

1. Obtain entry from the queue manager. 

2. Locate proper SIB entry. 

3. Determine entry type and branch to processing routine. 

4. NOP entry processing 

a) if device is idle, free the buffer and exit. 

b) for input files, gueue buffer with read reguest 

to external handler. 

c) for output files, issue a read call to the 
driver* 

d) for input/output files, use the fcuffer as 
indicated by the stream status flags (i.e., read 
from SP, read from external device, or show 
buffer as available). 
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6. Read entry process - if the device is active issue a 
read call to the driver, else free the buffet and exit. 

7. write entry process - if the device is active issue a 
write call to the driver, else free the buffer and 
exit* 

8. stop entry process - issue a write /control call to the 

driver. 

9* Error entry processing - if the device is active issue 

a write/control request indicating the error condition, 
else free the buffer and exit* 

10* Allocated buffer received - if a data buffer give it to 
requestor by gueueing as NOP through QM* If more 
buffers are required for this unit issue requests until 
satisfied or suspended* If all requests are satisfied,, 
search SIB's for units with pending requests and 
atteipt to obtain buffers for them* If the buffer is a 
control buffer restart the suspended device acd use the 
buffer as directed* 

11* Start entry process * mark the device as available foic 
use* If the device is a level 3 handler and an ADV has 
been received, enter the buffer acquisition routine* 

All of the above processes exit through «COfl»* The IC ccapleto 
section, ASFHC, will be dispatched whenever an I/O operation 
completes on the logical unit for ASCII files* Processing 
fellows this sequence: 

1* Obtain and save I/O cciplete entry* 

2. Locate designated SIB* 

3* Determine event type and dispatch appropriate 

processing routine* 

Dnsqljt^te^ 

4. Perform control function - obtain a control buffer and 
queue the required operation to the indicated handler.. 

5. Allocate Device - mark device as active; fcr level 2 
devices issue a S1ART to device handler* For level 3 
devices acquire buffers if a START has been received , 
else exit* 
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6. Transfer Buffer - If there is an unused buffer 
available (read/write device) queue it for reading to 
the indicated hardier. If none available set the Bead 
requested flag. for level 3 devices present a type 1 
device error if the host system is not connected. In 
all other cases nc processing is necessary. 

7. Allocate Buffer. - If there is an unused buffer 
available (read/write device) use it to read from the 
interconnect kit. If none is available, set the output 
pending flag. For level 3 devices, present a type 1 
device error if the host system is not connected. In 
all other cases, no processing is necessary. 

8. Kill Device Output - purge the queue of the indicated 
handler and set the SIB to show device inactive. 
Generate a stop command for associated handler. For a 
L3 device turn off the active flag and exit. 

9. Release device - Generate a stop command and queue to 
the associated handler. Nark the SIB entry as 
inactive. For a 13 device turn off the active flag and 
exit. 

Sch eduled 

10. BEAD complete - if the stream is inactive or KILLIO 
status is given, free the buffer. Otherwise queue the 
buffer for writing to the indicated handler. 

11. WHITE complete *• if the stream is inactive or KILLIO 
status is returned, free the buffer. If the device is 
a read/write device perform the action indicated by the 
SIB I and flags (i.e., read from external handler, 
read from SP, or show buffer as available). For other 
devices (read only) queue the buffer to the indicated 
handler for readicg. 

12. WRITE/CONTROL ccmplete * - if the buffer is non- 
dedicated, free it. Otherwise process like a WRITE 
completion. In the case of a level 3 device STOP 
completing, the buffer is queued back to the level 2 
handler as a STOP. 
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Interf acing 

The calling sequences acd exit procedures for the three entry 
points to ASFH are: 



start/ re start flag* 
logical unit for ICK 



AS£HI 




entry; 




LDA 


SRFLG 


LDB 


LOTNC 


JSB 


ASFHI 


exit: 




JHP 


ASFHI,I 


ASFHP 




entry: 




LDB 


ENTAD 


NOP 




JSB 


ASFHP 


exit: 




JHP 


•COM* 


iSfHC 




entry: 




LDA 


PHMWD 


LDB 


BUFAD 


JMP 


ASFHC 


exit: 




JHP 


• COM* 



entry address 



IOC para word 

buffer address/status 



The ASCII file handler utilizes the services of the buffer 
manager, queue manager, and allocate/deallocate manager* All 
device operations are carried out through the services of QIQC and 
the ASCII file extension of the D.61 driver. 
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i££Sl data structure s 

Associated with every ASCII file data streaa is a block 
containing status and control information. The streaa information 
blocks are ordered contiguously by stream id number (0-63). Each 
block is 6 words long so that any SIB address can be computed by 

SIBnn « 5IBC0 ♦ 6 * (stream id) 

The SIB entries are defined as follows: 

WORD 1 - STATUS 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


P 





I 


T 


W 


a 


S 


A 


B 


P 


X 



EC 

F - action required flag 

» 1 inclusive OR of bits 13 6 14 

* otherwise 

- output requested flag 

■ 1 if SP output is pending 
« otherwise 

1 - input requested flag 

» 1 if SP input is needed 

* otherwise 

T - level 3 translate mode 

= 1 no translation to EBCDIC 

■ translation to EBCDIC 

W - level 3 wait for buffer 

- 1 if level 2 module controls buffer when RDV received 

= if ASPH had buffer or , regained buffer following RDV 

R - restart flag 

« 1 stream is awaiting allocated control buffer 

= stream not held 

S -• start flag 

■ 1a start command has been sent or received 

» a stop or purge command has been sent or received 

A - activity flag 

« 1 an ADV has been received 

« an RDV or KDO has been received 
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E* - buffer availability flag 
= 1 buffer avail 
= buffer in use 

P - buffer request pending 

= 1 this stream has a buffer request pending 
- otherwise 

X - start timed retry underway for read/write device 
= 1 if yes 

= if no 

EC - buffer count 

number of buffers in use for this stream 

WORD 2 - Queue name 

name of gueue to which operations for this device are directed. 

WORD 3 - Device Requirements 

15 12 9 - B 7 6-5 4 3-2 1-0 

RCD DBC J L H ,T 

RCD - restart code for allocated central buffers 

3 - issue START 

4 - issue STOP 

5 - issue PURGE 

6 - issue ERROR 

7 - issue WRITE/CONTROL 

8 - issue CTRL 

9 - issue RETRY 

EBO device buffer count 

number of buffers needed for stream operation. 

J -' JI device flag 

= 1 - this is the JI device 

T - device type flag 

* - read/ write CTL only 

= 1 - write only 

= 2 - read only 

= 3 - read/write** 

M - mode 

= - for card reader 
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■ ' 1 - for printer 

L - device class flag 

* device class is level 2 
' ■'. 1 device class is level 3 

WORD «t - Buffer Address* 

address of buffer for this data stream** 
or buffer size 

WORD 5 - restart status if waiting for buffer 

status word for allocated control buffer 

WORD 6 - ASFH code restart address 

holds address of loeatien within ASFH to receive control 
when buffer is obtained 

Queuing and control information for inter-handler and 
handler-driver conmunications are contained in the buffer control 
words (BCW«s) prefixing all buffers, content descriptions are 
found under "Global data structures." 

* significant for read/write (type=3) devices only. 
**read/write (type 3) devices are always single buffered. 
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Card Eeader Handler 

Description and functio n 

This card reader handler (CRfl) can be activated by other 
handlers in order to read cards. The card images and any error 
indications are returned to the activating handler. CRH supports 
the reading of cards in ASCII or EBCDIC modes. The programming 
for this module is serially reusable. CRH is a level 3 function 
handler and responds to the defined level 2 - level 3 protocol. 

Interfacing 

CRH accepts these work entry commands: 

1. Start - received from a level 2 handler. Causes CRH to 
activate. 

2. Read - received frcm a level 2 handler. Causes CRH to 
read a card for the level 2 handler. 

3. StOF - received from a level 2 handler. Causes CRH to 
commence deactivation. 

4. Retry command - may be received from the level 2 
handler. Causes CRH to retry reading after being 
previously suspended due to data errors. 

5. Allocated buffers - received from the buffer manager. 
These are buffers which vere previously reguested but 
not available at the time of the re guest. 

6. Control - may te received from the level 2 handler. 
Causes CRH to sat device specific actions or cptions. 

CRH returns these commards to its activator: 

1. Nop .- an allocated read buffer (following a start) is 
being returned. ilso read buffers outstanding at the 
time of a stop will be returned as nop. 

2. Write - a completed read is being returned. 

3. Stop - the received stop command is returned following 
the return of all read buffers and deactivation. 

4. Error - an indication that a read error has occurred. 
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Loca^..data structu res 

The start coaaand is defined by the following BCH nerds: 



BCH word 2 - Bits 13-8 

3-0 
BCH word 3 - Bits 14-0 
BCH word 7 - Bits 15-0 
BCH word 8 - Bits 15-2 

1-0 

Data word 1 Bits 15-0 



streaa identifier 

co a Band" 3 

activating handler queue naae 

buffer length 

(unused) 

00 - ASCII 

10 - EBCDIC 

nuaber of buffers 



Card iaages returned by CfiH contain the following BCH 

definitions: 



BCH word 2 
BCH word 7 
BCH word 8 



Bits 13-8 

3-0 
Bits 15-0 

Bits 15-2 
1-0 



streaa identifier 

co«aand=1 

Nuaber of data bytes 

trailing blanks) 

(unused) 

00*no errors 

11*ead of file 



(excluding 



All other coaoands returned to the level 2 handler contain 
the appropriate streaa id in BCH2-bits 13-8. For the error 
coaaand, BCH8-bits 1-0 indicate the correct general errcr type. 



These 
by CRHs 

RTQE 

RHQ 

EH2T2 

RIOCP 

RACBC 

RSIZE 



synbolic indirect pointers to local data are also used 



a read retry TQE (tiaer queue eleaent) 

holds naae cf associated work queue 

holds the H2T2 queue naae or is zero if inactive 

holds configured IOC read paraaeter 

holds the current active buffer count 

retains length in negative bytes for read 

operations 

RQUIT - holds address of stop buffer if a stop is 

pending, otherwise zero 

RID - holds streaa id in bits 13-8, error condition 

bits in bits 1-0, and ready/not ready 
transitions in bit 15. 

RTYPE - zero if a card reader; one if a photo-reader (see 

description cf photo-reader handler) 
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Alg orithm 

CRH has four entry points: 

CRCHI - handier initialization, invoked by system 
initialization 

CBCHP - receives control from system dispatcher when 
primed by system queue manager 

CRCHC - receives control from system dispatcher when 
scheduled read operations have completed 

RTEI - receives control from tha time base generator 
handler when a timed pause expires (for read 
retries following not ready states) 

At each of these entry pcints, register A contains the 
address of the local data structure for some card read function* 
Subroutine RADDS is used by all four sections to generate a list 
of indirect addresses for access to the actual data. References 
to the local data names herein should be viewed as indirect access 
to the actual data locations* 

CRCHX receives the BCS logical unit number. for its associated 
card reader frcro the system initialization module. This number is 
merged into RIOCP for use as an IOC parameter word throughout the 
CRH module. CRCHI then issues a .FIND for its own queue name. 
This is needed by CRCHP to make .GETQ requests. The queue name is 
retained in RWQ. 

The entire handler is initially in an idle state. It is 
removed from this state by beiEg primed with a start command 
containing the queue name of an activating handler as well as that 
handler's desired mode of reading. Read commands are accepted 
following the start. Once started in this manner, CRH continues 
until a stop command appears. Then CRH returns to its idle state. 
The activating handler car re-activate CRH with a new start 
command. 

CRCHP processes all entries on its queue once primed. It 
then exits with its prime gate closed. These types of entries may 
be processed: 

1. start - the activator's queue name is retained as well 
as the indicated stream identifier in RB2T2 and RID. 
The reading mode is configured into RIOCP. The read 
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length is saved in RSIZE. Then the desired nuaber of 
buffers are acquired and returned to the activator. 

2. read - using the RSIZE length, a read operation is 
queued. The active buffet count in BACBC is 
incremented. 

3. stop - any pending timed retry is cancelled. Pending 
reads are purged. If the active buffer count is zero, 
the stop is immediately returned. Otherwise it is 
saved in RQDIT for future return. 

4. operator command - the device request queue is 
released. 

5. allocated buffer - a read buffer is given to the 
activator (if still alive) . A control buffer is used 
to dispose of an error message to the activator. 

6. control - undefined control parameters are ignored, 
others allow switching of read modes. 

CHCHC processes completed read operations. The active buffer 
count is decremented. If a stop is pending, the buffer is 
returned as a MOB. If any abortive error occurred (purged DBQ) , 
the buffer is returned as a MOP. If no error has occurred, the 
buffer is returned as a write with end-of-file possibly indicated. 
If an error has occurred, the buffer is placed back on the work 
quaue for CRCHP to retry. An error message is sent to the 
activator, and if a not ready type, a timed retry is scheduled. 
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I. Product Identification 
?£2^!3£i abst ract 

The D. 11 card reader driver is designed for use with the 
HP2000 ACCESS system. It supports both the 7261 and 2892 card 
readers. (The elder 2767 card reader uses an interface identical 
to that of the 7261. Thus it may also be used. However, this 
document claims no specific support.) The module is written in a 
serially reuseable manner. Hence, it will support multiple 
readers of any mix. (The HE2000 ACCESS system will support up to 
seven. ) 

II. Design Overview 
5§.Siaja assum ptions 

The module assumes a 5100 or 21MX series computer. It also 
requires the HP2000 ACCESS I/O processor microcode. The 2 892 
hardware end-of-file feature is supported. 

2©§iaH summary 

The complete driver consists of two distinct modules (D.110 
and D.11C). The D.110 module defines the actual driver initiator, 
continuator, and power recovery entry points associated with any 
given card reader. This is the only module which must be 
replicated to support multiple readers. The D. 11C module, which 
contains the actual code, is used by all copies of D.110. In 
addition, D.110 contains all data of a varying or potentially 
volatile nature which is required by each reader. This includes 
related I/O instructions, fcuffer pointers, reading modes, flags, 
etc. 

Cards may be read by the reader and optionally converted to 
ASCII or EBCDIC character codes. The original column binary card 
inage may also be requested. All reading is done with DMA. 

Power recovery processing allows for proper termination of 
all scheduled reads even though reader power may be lost. Error 
status will be appropriately set in this case. 

Error handling alio j 3 ths -let-sctto-i of pick fail, heppsr 
:\ill, Jiha coiiv^vsioa, cir-«1 o :- . >.«c errors. WVr;:-. the 72 5 i ?>ad .2092 
differ, errors are converted to a ccrancr. base. The occurrance of 
a " : : " (colon-colon) sequence in 'columns 1 and 2 of a card is 
treated as end-of-file. For the 2892, hardware end-of-file may be 
substituted for use of the " : : " card. 
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As stated above, the driver is written in a serially 
reuseable manner. Thus, the ore copy cf code, D.11C, serves all 
readers* D.11C accesses a given 0*110 storage block through a 
series cf indirect pointers* The use of these pointers is 
seriallized by D.11C* However, the driver will accept multiple 
card reader interrupts, gueueing each such interrupt for eventual 
service. 

The method of distinguishing between a 7261 and 2892 is via 
the subunit number (bits 1:6) in EQT word one* Subunit 
designates a 2892, subunit 1 a 7261. 

NfiliSie SiaiHizatjon 

D*11C contains code for I/O initiation (D.11C), I/O 
continuation (I.11C), and power recovery (P* 11 C) • Since calls to 
the D.11C section may originate both in the base level program (a 
JSB to .IOC*) and from IOC (a result of a call to .BOFR) , D.11C is 
forced into serial use by a GIF instruction* In this section, 
the call parameters are analyzed and a read is initiated* 
Allocation iof a DMA chancel also occurs* If no DMA channel is 
available, the call is rejected* (Queued .IOC. manages this 
condition by later rescheduling.) 

I. 11C, the continuatoc section, consists of three segments* 
The ficst accepts interrupts and gueues them for service* It will 
also dispatch the second segment for the first interrupter only* 
The second segment processes an inte erupt* The third segment 
dequeues a processed interrupt and reenters the second segment to 
process additional queued interrupts if any* When no interrupts 
remain, I/O retires are rescheduled as required* Note that only 
segments one and three need to run disabled* 

The P.11C power recovery section is entered for each card 
reader (via P. 110) from D.04. If the associated 1*110 section. was 
active, D*04? is used to raster© this condition* However, if the 
reader was not having an interrupt processed, but a read had been 
scheduled, an interrupt is forced to cause normal 1*1 1C error 
processing to effect recovery* 

IS^§IO£i seyvice 

The second segment of I. 11C first establishes the driver»s 
indirect pointer list to access the D.110 storage block for the 
reader whose interrupt is being processed. Next, error detection 
is done using a different status examination procedure for each 



4*-27 



reader type. For the 7261 only, up to 10 retries are attempted 
for pick failures before the error is considered "hard." The 2892 
hardware end-of-file status is recorded* (It may be overridden by 
simultaneous occurrence of a "::" card.) 

Next the significant data count is obtained using the DMA 
length control word. Note that this allows the 40 column feature 
of the. 7261 to be supported. Since the 7261 and 2892 column 
images are opposite, the 7261 image is reversed at this point. 
Row 9 will appear in computer word bit and the "twelve" row in 
word bit 11. 

The reading mode is exaiined next. Note that reading does 
not occur directly into the caller»s buffer. Rather, an 

intermediate 80 word buffer in D.110 is used. The data is now 
moved and converted from this intermediate buffer into the 
caller's buffer. The caller's length is honored and overrides the 
actual significant read lergth. In all cases, the returned 
transmission log reflects the number of columns read less any 
trailing blanks. This count may be less than the requestor's read 
length. Data is moved to the reguestor's buffer after possible 
conversion to ASCII or EBCCIC character representations. The 
detection of any erroneous punch combinations in this case will 
result in a data error status. The completed read operation is 
now signalled via .BUFR, and the used DMA channel is released. 

Ill, Design Structures 

IE^SX£S£S descri ption s 

C lea r 

Any current operation is aborted. DMA is released. The 
driver enters an idle, available state. 

JSB .IOC. 

OCT OOOOxx (xx^logical unit #) 

Read 

A card is read and transferred to the supplied buffer. 
Optional data conversion may cccur. 

JSB .IOC. 

OCT 010nxx (xx=logical unit f) 

JKP REJCT 

DEF BUFFR 

DEC m 
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m=positive number of desired card columns 
n=0 — ASCII read mode 

1 - column binary read mode 

2 - EBCDIC read mode 

The returned transmission log always reflects the number of 
card columns requested less any trailing blanks. The status word 
includes these bit definitions: 

HI = error 
1: C * - no error 

1 - pick fail or other not ready condition 

2 - data error 

3 - an «1 -of -file 
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LiS.3 f£JP£g.r Handler 

Des cripti on and func tio n 

The Line Printer Handler is responsible for normal flow of 
print lines to the printer and notification of its caller of 
printer errors and printer coupletion (end-of -f ile; obtained from 
calling program) • The Line Printer Handler will effect the 
emptying of tuffers througt the queue manager and calls to .IOC. 
to print user output on the line printer. The handler will adhere 
to the defined level 2-level 3 protocol. This module is written 
in a 'serially reusable' Banner with all locally used data 
accessed from a unique storage block. Thus, additional printers 
may be added by replicating this storage block. 

The handler has three entry points; a "prime" entry which is 
used when a queue entry exists and is to be processed and an "10 
complete" entry which is used when an operation initiated by the 
"prime" entry, has finished and the queue entry processed must be 
returned to the proper place; and an initialization entry called 
during system startup and restart. 

The "prime" entry will obtain an entry from the input queue 
and attempt to do a .IOC* call tc process the buffer. 

The "10 complete" entry will examine the returned information 
from a completed operation aid determine if an error occurred. If 
an error occurred, the handler will issue a priority .IOC. call to 
reschedule the request and inform the level 2 hankler of the 
error. If no error occurred, the entry will be returned to the 
proper handler queue. 

I nterfaci ng 

Input queue entries may be one of the following: 

1. Start - received from a level 2 handler in a control 
buffer. It activates the handler. 

2. Write - receive! frcm a level 2 handler. Contains data 
to be output to the printer. 

3. Stop - received from a level 2 handler in a print 
buffer. It causes the handler to begin termination 
processing. 
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4* Allocated buffer - received froa the buffer aanager. 

The buffer is received as a queue entry if nc buffers 
were available at the tiae cf the initial request. 

5. Control operation - recieved in a control buffer by a 
level two handler* It is used to perfori special 
carriage control operations when in the print-then- 
space node. The control buffer is freed by this 
handler. 

6. Start tiaed retries - received froa a level 2 handler 
vhen the printer fcas indicated a not ready condition* 

7. Purge - received froa a level 2 handler* A clear IOC 
call is aade to purge any outstanding write requests* 

Output queue entries aay be any of the following: 

1* NOP - an allocated write buffer or a coapleted write 

buffer is being returned to the caller* 

2. Stop - the stop coaaand received by this handler is 

being returned to the caller to indicate teraination 
processing is coaplete* 

3* Error - a notification that a write error has occurred* 

The start coaaand is defined as fellows: 

BCH word 2 - Bits 13-8 streaa identifier 

3-0 coaaand- 3 

BCW word 3 - Bits 14-0 activating handler queue naae 

BCW word 7 - Bits 15-0 buffer length 

BCW word 8 - Bits 1-0 00»space then print 

01»print then space 

Data word 1 Bits 15-0 nuaber of buffers 

The print buffer is defined as follows: 

BCH word 2 - Eits 3-0 coaaand=1 

BCH word 7 - Bits 15-0 length 

Data word 1- Bits 15-0 print-then- space, not used 

space-then- print , control 
Bits 1-0 zero 
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ERSHT is set when a printer error occurs and is not reset 
until a line is successfully printed. This mechanism is used to 
provide only one error notification tc the original sender when a 
printer malfunction occurs. PHBUF is used to store the address of 
the printer buffer in case suspension due to buffer not available 
occurs during error processing. 

The four entries to the handler are: LPHI, the 
initialization entry; LPHP, the primer entry; LPHC, the I/O 
complete entry; and LPHT, the timer expiration entry, it each 
entry point, subroutine PADDS is used to create a list of indirect 
addresses to the local data structure. 

In . the initialization section LPHI, the logical unit number 
of the device is saved and the handler* s gueue name is found and 
saved. 

LPHP handles one gueue entry at a time when it is primed. 
The gueue entries are processed as follows: 

1. start- - the activator's queue name, the stream ID, and 
the print mode ate saved. The reguired number of 
buffers are obtained and returned to the activator. In 
print-then-space mode, a write IOC call is made with 
control code agual tc one to cause a skip to top-of- 
form. 

2. print - in space-then-print mode, the PCF control code 
is moved from Data word 1 to BCW9 and the IOC call is 
issued. In print-then-space mode, the control code 
saved in LPCON is moved to BCW9 and the IOC call is 
issued. LPCON is then reset to the default control 
code (space 1 ) • 

3. control - the PCF control code is saved at LPCCN and 
the control buffet is freed. 

4. stop - the print buffer containing the stop command is 
used to issue an IOC call with length egual to and 
BCW9 control code equal to 3 (space 1). 

5. allocated buffer - the buffer may be a control buffer 
or a print buffer. The control buffer is used to send 
an error indication to the activator when a not ready 
condition occurs. The allocated print buffer is made 
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interlocked, the stream ID and NOP command are placed 
in BCW2 and it is sent to the activator. 

6. start timed retry - a timer is started and the buffer 
is freed. In the timer exit, a release IOC request is 
made to reinitiate the operation. 

7. purge - a clear IOC request is made and the buffer is 
freed. 

when control is received with indication of an I/O complete 
event the following sequence of events occurs: The status of the 
reguest is checked to determine success of this operation. If 
successful; bits 15 & 1U of register A or word 3 of the buffer 
prefix will be zero. In this case, the buffer is returned to the 
activator with command code=0. If availability is set tc one the 
device was net ready and the handler will issue a priority .IOC. 
call to requeue the unprocessed buffer. A control buffer is 
obtained and sent to the activator vith command code=6 to indicate 
the occurrence of the error. 
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I. Product Identification 
Product abstj 



The D. 12 line printer driver is designed for use with the 
TSB/2000G System and will support both post-spacing and pre- 
spacing print nodes for the 2607 r 2610, 2613, 2614, 2618, 2767, 
and 2778 line printers, 

II. Design Overview 
J2£Ji2£ as su mptions 

This driver is designed to run on a 2100 series computer and 
requires any one or more of the interfaces for the printers listed 
above. It also requires the microcode described in the Phase II 
Base Design. 

Design §u m ma, EV 

Two modes of operaticn are supported. In the pre-spacing 
print mode, the carriage control will be issued and then the 
characters in the buffer will be transferred to the printer. This 
line will not actually be printed until the next control operation 
is performed (carriage contrcl for the next line). Therefore,, it 
will be necessary to issue a control operation to the driver when 
and-of-file is reached. 

A post-spacing mode will also be supported. In this mode, 
the characters in the buffer will be transferred to the printer 
before the control operation is issued. 

All printer types listed above will be supported by this 
driver. The appropriate control function routine is determined by 
the unit number in the EQT. 

The following functions will be performed by D. 12: 

CLEAR - reset all status words and issue a clear control 
reguest tc the printer. 

WRITE - transfer a block of data to the printer and is§ue a 
control operation either before or after the characters are 
transferred. 
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£esi£n 3£joroa.ch 

This driver is written in a serially reusable manner. In 
crder to simplify' the additicn of printers to the system, the 
driver is composed of twc separate and distinct modules. The 
first contains the unique entry points and the local data storage 
for a given printer. When another printer is added to the system, 
only this code is replicated. 

The second mudule is the serially reusable code used by all 
copies of the first module. This common code, D.12C, is composed 
of three basic units; the initiator section, the ccntinuator 
section, and the power recovery section. The initiator section is 
entered on an IOC call and is all disabled code. This is 
necessary because it may be entered by . BUFR on the completion of 
a print line for any printer driver. The ccntinuatcr section 
handles one printer interrupt at a time. If another interrupt 
occurs while this section is in use, the interrupt will be queued 
and processed when the active cne is completed. In the power 
recovery section, the status of the printer driver is checked and 
a set control is issued if required to create an interrupt. 

JE&§i£2 stru ctures 
flaJSI I'^gtional anils 

Description 

The printer is cleared with a CLC instruction and all status 
words are cleared. 

I2£££f£££ d£S£Xi£ll2fi 

JSB .IOC. 

OCT 0000XX XX is the logical unit number 

No rejects are possible. 

AlaorJ.thm &esc M ri£tion 

1. Get printer status. 

2. Issue C1C to the printer. 

3. Update status word in the EQT. 
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4. Clear driver status flags. 

5, Return to caller. 



HRITE 



Description and function 



Transfer a block of data to the printer. The control 
operation is issued before or after the characters are transferred 
depending on the subfunction code in the' IOC call. 

The control operation is translated to the appropriate format 
control code required by the printer interface. The proper 
routine for. the translation is determined by the unit number in 
the EQT. The EQT unit numbers are defined as follows: 




1 
2 
3 



ElilLsSI ll££ 



2607, 
2613, 
2767 
2778 



261C, 
261fl 



2614 



The contrcl code for each printer line is located in Eits 15- 
8 of BCS 9. Control codes are defined as follows: 



Code 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 



Action Requ es ted 

end-of-file 
skip to chancel 1 
skip to channel 2 
skip to channel 3 
skip to channel 4 
skip to chatnel 5 
skip to channel 6 
skip to channel 7 
skip to channel 8 
skip to channel 9 
skip to channel 10 
skip to channel 11 
skip to channel 12 
suppress spacing 
true single space 
true double space 
true triple space 



Normal Effect 

ignored by driver 

top of form 

bottom of form 

next line 

next double line 

next triple line 

next half page 

next quarter page 

next sixth page 

next line 

next line 

next line 

next line 

suppress paper advance 

same 

same 

same 
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Channels 9 through 12 exist on line printer models 2613 and 
2618 for optional installation definition of additional VFU 
capabilities. They are identical tc channel 1 on the factory- 
supplied VFU tape. These channels do not exist on the 2607, 2610, 
and 2614 models and these cedes will result in the 'next line 1 
action for these printers* 

Ittfilf ASS - &&£L£lf i£i&i2&S 

JSB .IOC. 

OCT 020YXX where XX is logical unit nun ber 

and Y=0 for pre-spacing print mode 
Tf»1 fcr post-spacing print mode 
Reject Address 
Buffer Address 
Buffer length (fc. s, .^ati'.^j 

The call nay be rejected if the driver is busy. If so, the 
return is nade with: 
A=1 
8=100000 

The transmission log will reflect the number of characters 
transmitted to the printer. 

AlSSX^kS l£S£l4£iion 

If the driver is not busy, the print operation is started in 
the initiator section of the driver. Either the format control 
word (pre-spacing) or the first character in the buffer (post- 
spacing) is output to the printer. 

In the continuator section, the next character is output to 
the printer. When the buffer is exhausted, the format ccntrcl 
word is output (post-spacing mede) to the printer and then . BOTH 
is called. Interrupts that cccur while this section is in use are 
queued for later processing. Before exiting, this queue is 
checked for work and all queued interrupts are processed. 

All commands to the printer are channel type commands. 
Single and doufcle spacing are accomplished with »skip to channel 
3" and r skip to channel *»• cemmands respectively. 
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Paper T ape Punch H andler , 

D escript ion an,d fu nctio n 

The Paper Tape Punch Handler is responsible for normal flow 
of output to the paper tape punch and notification of its caller 
cf errors and completion (end-of-f ile; obtained frcm calling 
program). The Paper Tape Pucch Handler will effect the emptying 
of buffers through the gueue manager and calls to .IOC* to punch 
user output on the paper tape punch. The handler is written in a 
'serially reusable' manner and will adhere to the defined level 2- 
level 3 protocol. 

The handler has four entry points? a "prime" entry which is 
used when a gueue entry exists and is to be processed; an "'10 
complete" entry vhich is used when an operation initiated by the 
"prime" entry has finished and the gueue entry processed must be 
returned to the proper place; a timer entry used when a timer 
expires; and an initialization entry called during system startup 
and restart. 

The "prime" entry will obtain an entry from the input gueue 
and attempt to do a .IOC. call tc process the buffer. 

The "10 complete" entry will examine the returned information 
from a completed operation ard determine if an error occurred* If 
an error occurred, the handler will issue a priority .IOC* call to 
reschedule the reguest and inform the level 2 handler of the error 
condition. If no error occurred, the entry will be returned to 
the proper handler gueue. 

interfacing 

Input gueue entries may be cne of the following: 

1. Start - received from a level 2 handler in a control 
buffer. It activates the handler. 

2. Write - received frcm a level 2 handler. Contains data 
to be output to tfce paper tape punch. ' 

3. Stop - received from a level 2 handler in a write 
buffer. It causes the handler to begin termination 
processing. 
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4. Allocated buffer - received from the buffer manager. 
The buffer is received as a queue entry if nc buffers 
were available at the tine of the initial request. 

5. Start timed retries - received from a level 2 handler 
when the paper tape punch has indicated a net ready 
condition. 

6. Purge - received from a level 2 handler. A clear IOC 
call is made to purge any outstanding write requests. 

Output queue entries may be any of the following: 

1. NOP - an allocated write buffer or a completed write 
buffer is being returned to the caller. 

2. Stop - the stop command received by this handler is 
being returned to the caller to indicate termination 
processing is ccmjlete. 

3. Error - a notification that a write error has occurred. 

The start command is defined as follows: 

BCW word 2 - Bits 13-8 stream identifier 

3-0 command*3 
BCW word 3 - Bits 14-0 activating handler queue name 
BCW word 7 - Bits 15-0 buffer length 
BCW word 8 - Bits 1-0 00»punch mode in Data wcrd 1 

01*punch mode changed by 
control operation 
Data word 1 Bits 15-0 number of buffers 

The write buffer is defined as follows: 

BCW word 2 - Bits 3-0 command* 1 

BCW word 7 - Bits 15-0 length - positive bytes 

Data word 1- Bits 15-8 punch mode - RJE 

7-0 zero 

A^gor^thm 

The algorithm for processing is given below: 

ERSWT is set when a punch error occurs and is not reset until 
a line is successfully printed. This mechanism is used to provide 
only one error notification to the original sender when a device 
malfunction occurs. BUPPB is used to store . the address of the 
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write buffer in case suspension due to buffer not available occurs 
during error processing. 

The four entries to the handler are: PPCHI, the 
initialization entry; PTHP, the primer entry; PPCHC, the I/O 
complete entry; and PPCHT, the timer expiration entry. 

In the initialization section PPCHI, the logical unit number 
of the device is saved and t fce handler's queue name is found and 
saved. 

PPCHP handles one queue entry at a time when it is primed. 
The queue entries are processed as follows: 

1. start - the activator*s queue name, the stream ID, and 
the mode are saved. The reguired number of buffers are 
obtained and returned to the activator. An ICC call is 
made to create the tape leader. 

2. write - an IOC call is made to output the characters in 
the buffer. 

3. stop - the output buffer containing the stop command is 
used to issue an IOC call which causes the driver to 
emit a trailer. 

4. allocated buffer - the buffer may be a control buffer 
or a write buffer. The control buffer is used to send 
an error indication to the activator when a net ready 
condition occurs. The allocated write buffer is made 
interlocked, the stream ID and NOP command are placed 
in BCW2 and it is sent to the activator. 

5. start timed retry - a timer is started and the buffer 
is freed. In the timer exit, a release IOC request is 
made to reinitiate the operation. 

6. purge - a clear IOC request is made and the buffer is 
freed. 

When control is received with indication of an I/C complete 
event the following sequence of events cccurs: The status cf the 
request is checked to determine success of this operation. If 
successful; bits 15 & 14 of register A or word 3 of the buffer 
prefix will be zero. In this case, the buffer is returned to the 
activator with command code*C. If availability is set tc one the 
device was not ready and the handlar will issue a priority .IOC. 
call to requeue the unprocessed buffer. A control buffer is 
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obtained and sent to the activator with conmand code=6 tc indicate 
th9 occurrence cf the error. 
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I. Product Identification 

£l2^J3£i 3J2§££§ ct 

The D. 13 tape punch driver is designed for use with the 
HP2000 ACCESS system, it supports the HP 12926A paper tape punch 
subsystem. The module is written in a serially reuseatle manner. 
Hence, it can support multiple tape punches, {The HP2000 ACCESS 
system will support up to seven.) 

II. Design Overview 

££. JA^n assumptions 

The module assumes a 2100 or 21MX series computer* It also 
requires the special microccde developed for use in the I/O 
Processor of the HE2000 ACCESS system. 

2S5A2S summary 

The complete D.13 driver consists of two distinct modules 
(D.130 and D.13C). The D.13C module defines the actual driver 
initiator, continuator, and power recovery entry points associated 
with any given tape punch. In addition, it contains all storage 
(constants, pointers, I/O instructions, etc. ) which is unique to 
that given tape punch. Tha D.13C module contains the actual code 
used to drive the device. It is called by the D. 130 module and 
then utilizes the unique storage provided by the caller to 
associate itself with a specific tape punch. 

The operation of the tape punch includes provisions for 
punching leaders and trailers and for punching data in record mode 
or transparent mode. In the record mode, each buffer cf data is 
punched and an X-OFF, carriage return, line feed sequence is then 
appended by the driver. Each record may be punched with even, odd 
or no parity. The parity punches are supplied by the driver. 
(Except for no parity for which no alteration of level eight 
occurs.) In the transparent node, no modifications to the data are 
made. 

Power recovery operation includes the punching of a record 
delete sequence (control-X, carriage return, line feed). Also, 
any record currently being punched is restarted. 

Error handling allocs only for a "not ready" error 

indication. A non-process timeout is a provision of the driver 

intended to make up for the general lack of status bits in the 

tape punch interface. Each tiire a tape fram? is punched (i.e. 
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started) , a 1 second timer is started. If the timer expires prior 
tc a punch complete interrupt, the punch is considered down and a 
"not ready" error is set. The occurrence of a low tape supply 
also causes a "not ready' 1 error. 

£&§!££ SBproa,ch 

As stated above, the driver is written in a serially 
reuseable manner. This means that a single copy of D.13C (the 
code) is used by multiple copies (and, hence, multiple tape 
punches) of D. 130. Access tc the storage in a given "D.130 module 
by D. 13C is done via indirect addressing through an indirect 
pointer list. This pointer list can only address one D.130 module 
at a time. E. 13c is thus forced to run serially to preserve the 
integrity of this list. Later descriptions will show, however, 
that this does not impare the driver* s ability to handle multiple 
interrupts from different tape punches. 

The following documentation will confine itself to a 
description of the D.13C module. 

&o£j2le or£a,nJ>2££icn 

D. 13C contains code for I/O initiation (D. 13C) , I/O 
continuation (I.13C), pow^r recovery (P.13C), and ncn-process 
timeout handling (T.13C). Since calls to the D.13C section may 
originate both in the base level program (a JSB to .IOC.) and from 
IOC (a result of a call to . EUFR), D.13C is forced into serial use 
by a CLF instruction. In this section, the I/O call parameters 
are analyzed and established, and the initial I/O operation is 
begun. 

I.13C, the continuator section, consists of three segments. 
In the first segment, an interrupt is accepted, and the D.130 
storage for the associated punch is enqueued to a linked list of 
storage blocks which require interrupt service. This is dona 
without disturbing any of the module's indirect pointer list. If 
this engueueing process determines that the interrupting punch is 
not the first (at least one ether storage block is already 
enqueued) , then an interrupt exit is immediately made. This is 
possible because the first storage block to ba enqueued will cause 
entry to the second segment cf I.13C which will begin to process 
all such interrupts. 

In the second segment, the top D.130 storage block on the 
interrupt service queue is processed. The indirect pointer list 
is set for -this block, and the interrupt is processed. (See 
discussion of actual interrupt service below.) Following 
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interrupt service, the third I.13C segment receives control. It 
disables the system and removes the top D.130 storage block from 
the interrupt service queue. If other blocks are still queued, 
the second segment of I.13C is entered again. When all D.130 
storage blocks have been serviced and dequeued, required 
additional I/O is begun for all punches needing same. Then an 
axit from the original (vary first) tape punch interrupt is made. 

The P.13C power recovery section of the module is entered for 
each tape punch (via P. 130) at power recovery time. It is called 
as a subroutine from D.OU aid takes appropriate action to restore 
service. P. 13C always emits a record delete sequence consisting 
of control-x, carriage return, line feed. This is to cancel the 
affect of any spurious punches associated with power restoration 
at the punch itself. (This sequence is punched with even parity, 
since it may be impossible tc determine tha mode in current use.) 
Finally, the proper state of the device's flag- and control bit 
settings is restored. 

Since the driver uses timed punch operations to detect "down" 
punches, a common T. 13C ncn-prccess timeout exit is a part of the 
driver. It receives control from the D.43 time base generator 
module. T. 13C first checks for a set flag on the punch. This 
would indicate that an interrupt is pending but has net yet been 
allowed. No error is indicated in this case. However, if the 
flag is clear, the non-prccess timeout error bit is set, and an 
interrupt is forced in ordar tc effect recovery by the interrupt 
processor. 

The second segment of I.13C processing is the interrupt 

service segment. Interrupts occur either because of a scheduled 

operation completing, or because an interrupt is forced when a 
non-process timeout occurs. 

The first action of the interrupt service code is to 
acknowledge the interrupt with a CLC instruction. Next, errors 
are checked. If a non-process timeout or low tape supply exists, 
tha operation is immediately terminated with a call to .BUFR. If 
no errors have occurred, the power recovery flag is tested. If 
set, the original I/O operation parameters are restored so as . to 
affect a complete restart of the current operation in the 
remainder of the processing. Finally, the character output 
routine is invoked to select and output the next appropriate 
frame. If no more data remains, the operation is instead 
terminated via .BUFR. 
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The character output rcutine is used both by D.13C to output 
the first fraae and by I.13C for subsequent frames. The routine 
first checks for operation end, updating buffer pointers and 
lengths in the process* Thee the node is checked. Either a feed 
frame is selected or a record datum. In the case of record data, 
parity is applied as required. Additionally, at record end for 
ASCII modes, an X-OFF, carriage return, line feed sequence is 
appended, when the character has been selected and output, the 
type of entry is checked. If entered from D.13C, an STC 
instruction and its timer are invoked to start the punching. If 
an I. 13C entry, the STC instruction is enqueued for future 
execution by the third segment of I.13C. This is to prevent an 
interrupt on a punch whose D.130 storage block is engaged in 
servicing other tape punch interrupts. (That is, it vas the 
original interrupter.) 

III. Design Structures 

£, j.ear 

Any current operation is aborted. The driver enters an 
available and idle state. 

J SB .IOC. 

OCT OOOOxx .■ (xx=logical unit #) 

A block of data is transferred tc paper tape. Optionally, a 
leader (or trailer) may be produced. All such operations are 
scheduled with a basic write command with appropriate mode 
settings for the various punch types. 

JSB .IOC. 

OCT 02nnxx (xx=logical unit #) 

J HP REJCT 

DEF DATA 

DEC m 

m=number of bytes of data to be output (or number of 
leader/trailer frames) in fc lus by tes 

nn=00 - ASCII mode with even parity 

01 - ASCII mode with odd parity 

. 02 - ASCII mode with no parity 

03 - transparent mode 
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20 - leader/trailer mode 

In the nri=20 case, the data buffer address is insignificant. For 
the 00 to 02 modes only, X-OFF, carriage return, line feed is 
appended by the driver to all records. No parity means that no 
alteration of the eigth level cccurs. It is forced neither high 
nor low. It remains as suppHsd by the caller. 

JS£lL£.yji information 

The transmission log always returns the original length of 
the caller 1 s reguest. This is to facillitate retries. The status 
bits include bit 1U which indicates the occurance of some error 
and bit which is one to indicate the occurance of a punch "not 
ready" condition. 
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P hoto-Reade r Ha ndler 

Description and fu nctio n 

• The programming for this handler is the same as that for the 
card reader handler. Where it is necessary to distinguish between 
a card reader and a photo-reader, the code tests a variable in the 
respective local storage to determine the appropriate action. 
Actions specific to the photc-reader are outlined below. 

In CRCHI, the photo-reader type causes an alternate device 
designator to re used in finding the associated queue name. 

In CRCHP, these alternate command- processes occur: 

■1. start - differing read mode indicators are established 

in the .IOC. paranetei word 

2. control - different set of control paraneters is 

allowed to set varying .IOC. parameters. 

In CRCHC, if EBCDIC reading is selected, the translation from 
ASCII to EBCDIC occurs at this level. 
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I. Product Identification 



Product Abstract 



The D. 14 paper tape photo-reader driver is designed for use 
with the 2000 ACCESS system. It supports the 2748 reader. 
Because it is written in a serially reusable manner, it will 
support multiple readers. (Ihe 2000 ACCESS system will support a 
maximum of seven) 

II. Design Overview 

H&siSlIi Assumptions 

The module assumes a 2100 or 21MX series computer. It also 
requires the 2C00 ACCESS Firninare option (13206A or 1320*/A) • 

C^sign Summary 

The complete driver consists of two distinct modules (D.140 
and D.14C). The D. 140 module defines the actual driver initiator, 
continuator, timer, and pewer recovery entry points associated 
with any given reader. This is the only module which roust ba 
replicated to support multiple readers. Ths D. 14C module, which 
contains the actual code, is used by all cop-ies of D.140. Tn 
addition, D.140 contains all data of a varying or potentially 
volatile n3ture which is reguired by each 
related I/O instructions, buffer pointers, 



reader. This includes 
flags, etc. 



The driver supports four modes of tape reading. Three modes 
provide for varying types of ASCII data formats, and the fourth 
mode allows transparent reading. The only difference between the 
ASCII modes is in the form of parity testing $cven, odd, or none). 
In the transparent mode, any and all frame punch combinations are 
valid. 

Power recovery processing allows for proper termination of 
all scheduled reads even though reader power may be lost. Error 
status will be appropriately set in this case. 

Error handling allows the detection of parity errors for 
appropriate reading modes. Since the reader interface has no 
inherent "not ready" status, all read operations are timed, and a 
read timeout is used to effect not ready errors. For the ASCII 
reading modes, an end of file condition is defined by the 
occurrence of 80 or more consecutive null frames. 
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Design, A£££2ich 

Since the driver is written in a serially re useable Banner, 
one copy of code (D. 14C) serves all readers. D.14C accesses a 
given D. 140 storage block via a series of symbolic indirect 
pointers. The use of these pointers is serialized by D. 14c. 
However, the driver will accept multiple reader interrupts, 
queueing each for eventual service. 

US^JJiS Q r^aqj^ atiron 

D.UC contains code for I/O initiation (D.14C), I/O 
continuation (LUC), power recovery (P.14C), and timer expiration 
(T.14C). Since calls to the initiator section may originate from 
both a base level program (a JSE to .IOC.) and from IOC (a result 
of a call to .BOTH), D.14C is? forced into serial use ty a CLF 
instruction. In this section of the driver, the call parameters 
are analyzed and a read may be initiated. 

I.14C, the contiuuator section, consists of three segments. 
The first segment runs disabled and enqueues the interrupting 
1.140 module for eventual interrupt service. The first such 
module enqueued causes the second segment to be entered. Segment 
two removes an enqueued I. 1 40 module and establishes the indirect 
symbolic pointers to the module data. Then the system can be 
enabled while the interrupt is serviced. Interrupt service 
includes accepting the input datumand adding it to the caller's 
buffer. Parity, end of file, and other tests are performed. At 
the end of interrupt service, segment three gains control. The 
system is disabled, and the module is dequeued. If other modules 
require service, segment two will be re-entered. 

P. 14C gains control from the D.04 power fail/restart module 
for each P. 140 entry point. If the associated 1.140 section was 
active, D.04? is used to restore this condition. However, if the 
reader was inactive (1.140 iractive) but a read had been started, 
an interrupt is forced to cause I.14C to effect recovery. 

T. 14C gains control if a given T.140 timer has expired. This 
indicates a failing read. Orless an interrupt is pending, one is 
forced to cause normal recovery. 

SSiiM-lii Detail 

These symbolic indiract pointers are used in D. 14C to access 
D. 140 data: 

PREQT - holds related ECT address 
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PRIOR - holds address 
PFLAG - driver flags: 



of last .IOC. parameter list 





15 - 


tusy driver 






14 - 


skipping for CR 




13 - 


resune reading after control-X 




12 - 


1-data has been read 




10:8 - 


device status 

0=ready 

1=read tine out 

2=unrecoverable read error 

3=data error 

7=end of file 




2:1 - 


C*even parity 
1=cdd parity 
2=no parity 




- 


1*transparent node (bits 2:1 ignor 
C=JlSCII mode (bits 2:1 apply) 


PBUFR 


- holds byte address of input 


PLENG 


- holds negative 


read length 


PLL 


- holds original 


read length 


PEOFL 


- holds negative 


count for EOF detection 


PSTC 


- STC subroutine 


(uses PFRIO and therefore has STC 




word) **r 






PTQE - 


a four word TQE 


for read timing 


PCLC - 


associated CLC - 


Instruction 


PLIA - 


associated LIA . 


Instruction 


PSFS - 


associated SFS 


instruction 


PSTF - 


associated STF 


instruction 





flag 



These data are specific to D.14C: 

PIOQ - a queue for pending STC instruction 

PEXIT- pointer to intarrupting I. 140 entry point 

PINQ - a gueue for interrupt service 

1.14 - pointer to 1st interrupting 1.140 entry point 

. BUFP- .BUFR EQT parameter 



The following 
module detail. 



"structured" description provides internal 



D. 140: JSB to D. 14C; 

D.14C: disable; save registers; 

establish indirect pointers to D.140 storage 

using contents of D.14C as base address; 

transfer contents cf D.140 to D. 14C; 

restore registers; 

store A into PREQ1 and B into PRIOR; 
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load and isolate tits 14:12 of I/O request 
parameter in register A (PRIOR indirect) ; 
if A=0 (clear) then do; 

issue CLC tc stop interface; 

purge timer using .LTC; disable on return; 

clear drivar flags (PFLAG) ; 

set EQT status to zero; 

exit via D. 14C; 

end; 
if PFLAG bit 15 is s€t then do; 

set A=1 to shew reject; 

set B=10000C tc show device busy; 

enable interrupts; 

exit via D. 14C; 

end; 
if A«1 (read) then do; 

load B from PRIOR; 

load buffer address into A (LA 1+2); 

convert to byte address and save in PBUIR; 

load read length into A(LAI+3); 

copy into ELL; 

negate and save in PLENG; 

load request parameter (LAI+0); 

isolate bits 8:6 

and align tc A register 2:0; 

merge A intc PFLAG; 

set PFLAG bit 15 to show driver busy; 

clear PFLAG tit 12 to show no 

data yet read; 

set EQT word 2 bit 15 to show EQT busy; 

set PEOFL tc -80 for possible EOF detection; 

JSB to R. 14C to start read operation; 

clear A to shew read started; 

enable interrupts; 

exit via D.14C; 

end; 
set A=1 to show reject; 
set B=0 to show illegal request; 
enable interrupts 
exit via D. 14C; 

R.14C: RSS if D. 14C in control via .IOC. call; 

JMP TO R. 14E (if C.14C in ccntrol while I.1UC active) 

JSB to PSTC; 

call .LIS. with ?1QE; 

disable on return from .LTS.; 

return; 
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R.14E: 



load address 


of 


PIOC into A; 


load address 


of 


PSTC into B; 


enqueue PSTC 


to 


PIOC; 


return; 







I. 140: JSB to I. 14C; 

I.14C: disable interrupts; save registers; 

move address of 1.140 to PEXIT; 
clear PSTC flag fcr power recovery; 
generate address cf associated TQE in register A; 
call . LTC. to cancel timer, and disable interrupts on return; 
load contents of I.14C into B and decrement B; 
load address of PINC into A; 
enqueue 1.140 storage to PINQ; 
if not first storage enqueued then do; 

restore registers; 

exit using PFREI to restore 

interrupts and exit via PEXIT; 

end; 
move PEXIT to 1.1 U; 
change RSS at R. 1 tc to nop; 

E.14C: enarle interrupts; 

load address of enqueued 1.140 storage (PINQ); 
establish contents of indirect pointers; 
issue CLC to acknowledge interrupt (PCLC) ; 
if FFLAG bits 9:8-1 or 2 then go to E.14C; 
if PFLAG bit is set then do; 
use PLIA to lead datum; 
load B from PEUFR; 

store byte frcm A via B and store B into PBUFR; 
increment PLENG; 
if zero then go tc E.14C; 
JSB to R.14C for next frame; 
go to F.14C ; 
end; 
else do; 

use PLIA to lead datum; 

if PFLAG bit 12 is clear and A=0 then do; 
increment PEOFL; 
if zerc then do; 

set PFLAG bits 10:8; 
gc to E. 14C; 
end; 
JSB tc P.14C; 
go to F. 14C; 
end ; 
if PFLAG bit 2 is clear then do; 
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calculate number of bits in A; 

if even and PFLAG bit 1 is set 

or if odd and PFLAG bit 1 is cleat 

then do; 

set PFLAG bits 9: 8; 
end; 
aask A to seven bits; 
if A=carriage return then go to E, 14C; 
if PFLAG bit 14 set then do; 

JSB tc !»• 14C; 

go to P.14C; 

end: 
if A=0 v * «1I ' &«2.« u A=177 
then do; 

JSt> t .-: I .*.; 

go to F*14C; 

end; 
if. A=30 then do; 

restoie original length; 

set oiiginal buffer pointer; 

set PFLAG bits 14 and 13; 

JSB tc R. 14C; 

go to F.14C; 

end; 
if A=10 thea do; 

reduce length; 

reduce buffer pointer; 

JSB tc B.14C; 

go to F.14C; 

end; 
load B from PBUFR; 

store byt^ from A and restore B to PBUFR; 
set PFLAG bit 12 to show data read; 
increment PLENG; 
if zero ther dc; 

set PFLAG bit 14; 

end; 
JSB to R. 14C; 
go to F.14C ; 

E # 14C:^ load PFtAG into A; if PFLAG bit 13 is set 
then do; 

clear PFLAG bits 14 and 13; 

JSB to R. 14C; 

go to F.14C; 

end ; 
isolate bits 10:8 cf A into bits 2:0 of A; 
if A not then s€t A bit 14; 
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store A into EQT status word; 

add PLL and PLENG and move to 

EQT transmission leg; 

move PREQT to . BOIP; 

JSB to •BOPB with return to F. 14C; 

F.14C: disable interrupts; 

dequeue 1.140 storage from PINQ; 
if PINQ not empty then go tc B.14C; 

G. 14C: dequeue PSTC from FIOQ; 
if none then do; 

restore ESS at B.14C; 

restore registers; 

exit using PFREI to restore 

interrupts and exit via 1.14; 

end; 
JSB to the dequeued PSTC; 
call .LIS. to start associated timer; 
disable on return from «LTS«; 
go to G.14C; 

T. 140: JSB to T. 14C; 

1.1 4C: use TQE address tc generate address of 

associated SFS; 

execute SFS; 

if flag set then exit via T.14C; 

generate address cf PFLAG; 

set PFLAG bit 8; 

generate address cf PSTC and execute same; 

generate address cf PSTF and execute same; 

exit; 

P. 140: JSB to E. 14C; 
P.14C: set PFLAG bit 9; 

if I. 140 not then do; 

set E=-1; 

load ILIA into A; 

call E.C4?; 

exit; 

end; 
if PSTC flag = zerc then exit; 
load PSTC instruction; 
change to STC (no clear flag) ; 
execute in-line; 
exit; 

III. Design Structures 
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Interface DescriEt ^ons 

Clear 

Any current operation is aborted. The driver enters an idle, 
available state. 

JSB .IOC. 

OCT OOOOxx (xx*logical unit #) 

Read 

A record is read frcm paper tape and transferred to the 
supplied buffer. 

.IOC. 

(xx=logical unit #) 



JSB 


.IOC. 


OCT 


010nxx 


JMP 


REJCT 


DEF 


BOFFR 


DEC 


n 



Expositive number of frames to be read 
n=0 - even parity ASCII mode 

1 - transparent mode 

2 - odd parity ASCII mode 
4 -• no parity ASCII mode 

Status Information 

The returned transmission log is always equal to the number 
of data frames read. The status word includes these definitions! 

14 - error 
2:0-0 no errcr 

1 reader not ready 

2 power failure 

3 parity error 
7 end of file 
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Reader Punch Interpreter H andler 



The reader/punch/inter treter handler (RPH) manages all I/O 
for the. reader punch driver. It may be activated by other 
handlers to read cards, punch cards, or print on cards, when 
activated by the ASCII files handler it nay be used for both read 
and write operations, when activated by an RJE module it will be 
used either as a card reader handler cr a card punch handler, but 
not bcth simultaneously. 

The handler supports the reading of cards in column binary, 
ASCII, or EBCDIC. It supports punching cards in Hollerith or 
column binary. The handler is written as a serially reusable 
module. It is a level 3 function handler and responds to the 
defined level 2-level 3 protccal. 

RPH has one input queue for all work entries. These commands 
may appear on the input work gueue: 

1. Start - received froi a level 2 handler. Activates the 
handler. 

2. Read - received from a level 2 handler. The handler uses the 
buffer to read a card. 

3. Write - received from a level 2 handler. The buffer contains 
data to be punched and/cr printed. 

4. Control - received from a level 2 handler in a control 
buffer. It contains a FCF code in the data word. 

5. Stop - received from a level 2 handler and causes the handler 
to begin termination processing. 

6. Retry - received froi a level 2 handler and causes th* 
handler to retry the read or write operation. 

7. Purge - received from a level 2 handler. A clear call is 
made to IOC to purge any outstanding I/O requests. 

8. Allocated buffers - received from the buffer manager in 
delayed response to a request for a buffer. 
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The following commands lay be returned to the activator: 

1. NOP - a completed write buffer is being returned to the 
caller, or an allocated buffer is being sent to the 
activator. 

2. Write - a completed read buffer is being returned to the 
caller. 

3. stop - the received step command is being returned following 
the completion of all outstanding I/O requests. 

4. Error - an indication that a read or write error has 
occurred. 

L2££l £&Sl Str ucture s 

The start command is defined by the following BCW words: 

BCW word 2 - Bits 13-8 stream identifier 

54* word 3 - Bits 14-0 activating handler gueue naae 

BCW word 7 - Bits 15-0 buffer length 

BCW word 8 - Eit 15 start for read only or write only 

(HJE mode) 
1-0 read mode (if bit 15 on) 

C0» ASCII 

C1*column binary 

10=1 BCDIC 
Data word 1 - Bits 15-0 number of buffers 

Card images returned tc the activator have the follwcing BCM 
definitions: 

BCM word 2 - Bits 13-8 stream identifier 

3-0 coamand*1 
BCW word 7 - Bits 15-0 nuaber of data bytes 

(excluding trailing blanks) 
BCW word 8 - Bits 15-2 unused 

1-0 C0*no errors 
11=end of/ file 



For the error command, BCW2-bits 13-8 contain the stream 
identifier and BCW8-bits 1-0 contain the general error type. 

The following define indirect pointers to local data: 

TQE TQE 

QNAME RPH queue name 
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AHQNM activating handler gueue name 

RIOCP read IOC pari 

WIOCP write IOC pari 

CIOCP control ICC parm 

STAT error status 

STID stream ID 

RLEN read length 

BUFFR buffer address 

STOPB stop buffer address 

ACTBC active read buffer count 

FLAGS flags 

bit 15 not ready error condition 

1<* purge active 

11 stacker salection 

10 hopper selection 
1=RJE mode 
0=TSB mode 

Al£Olith£ 

The reader/punch/interpreter handler has four entry points: 

RPHHI - handler initialization, invoked by~ 
system initialization 

RPHHP - receives control from system dispatcher 
when primed by system gueue manager 

RPHHC - receives control from system dispatcher 
when scheduled read, write, or control 
operations have completed 

RPTAP - receives cotnrol frcm the time base generator 
handler when a timed pause expires (for 
read or write retries following not ready states) 

The following "structured" description provides internal 
module detail* 

RPOHI: entry point for initialization section. 
JSB to common code (RPHHI) 
return through entry point 

RPHHI: initialization section of common code; 

if restart, return; if start, merge logical unit 
number with ice calls; use . FIWD to determine queue 
name; exit; 
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BPOHP: 
HPHHC: 



STAHTs 



STBUF: 



BEAD: 



entry point fcr prime section; JSB to coaaon codes 
return through entry point; 

priae secticn cf coaaon code* 

establish addressing for local storage; 

check work gueue; 

if no work, exit via •COS* 

else; if gueue was purged, 

use PfiGES subroutine to clear device; 

exit to coaautator; 
save vork ertry address; 
use coaaand type to enter appropriate 
routine (START, BEAD, WRITE, CHTHL, STOP, 
PURGE, RETBY, ALLBF) 

routine to feandle start coaaand* 

save streaa ID; 

save activating handler gueue naae; 

if read only acde or write only, indicate HJE aode; 

set default nodes for stacker 1, hopper 1; 

set Hollerith punch aode; 

set EECDIC read aode; 

set to punch, print saae data 

issue control IOC call to set stacker 

overflew aode; 

continue START processing at STBOF 
if read/write acde, indicate TSB aode; 

sat default nodes for stacker 1, hopper 1, 

set ASCII read node; 

set Hollerith punch aode; 

set to punch, print saae data; 

issue control IOC call to set stacker 

select aode; 
acquire buffers; 

give to activating handler as NOP; 
free start buffer; 
exit to commutator; 

read coaaand processing* 

create IOC para froa flags and read aode; 

zero out read buffer; 

issue IOC call* 

indicate read buffer active; 

exit to coaiutator; 



WRITE: 



write coaaand processing 

if RJE mode, get punch aode froa buffer; 
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else get pucch node frcin write IOC pari; 
create IOC para with flags and punch mode; 
issue IOC call; 
exit to comutator; 

CNTRL: control coroirand processing. 

if immediate type control, s9t mode; 
free control buffer; 
. exit to commutator; 
else; set up control call to driver; 
issue IOC call; 
free ccntrol buffer; 
exit to commutator; 

STOP: stop command processing* 
purge timer if running; 

if read buffers active, issue CLEAR IOC call; 
else; issue clear wait station IOC call; 
indicate step in progress; 
save address of stop buffer; 
exit to ccmnutator; 

RETRY: retry command processor, 
start a timer; 
free retry command buffer; 
exit to ccmiutator; 

PURGE: purge command processing, 
purge tioar if running; 
purge device reguest gueue; 
free purge command buffer; 
indicate purge processing; 
exit to cennutator; 

ALLBF: allocated buffer processing. 

if no longer running, free the buffer; 
else; if ccrtrcl buffer; use for error report to 
activating handler; 
else; give to activating handler as NCP; 
exit to comiutator; 

The following modules make up the I/O complete section of the 
handler. 



RPOHC: 



entry point fcr I/O complete section, 

JSD to commen code; 

end; 
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BPHHC: I/O complete section cf conaon code. 

establish addressing for local storage; 
if call was clear wait station, then; 

return stop buffer to activating handler; 

exit to commutator; 
if call was read, enter CREAD; 
else call was write; 

CWRIT: handle write complete • 

if no error, return to activating handler as MOP; 
else; save buffer address; 
if first tite, then; 

turn en error flag; 

send error command to activating handler; 

issue priority IOC call with same buffer; 

exit; 
else; start timer; 

issue priority IOC call with same buffer; 
exit ; 

CRIAD: handle read complete. 

decrement active buffer count; 

if stop in progress, give buffer to activating 

handler as NOP; 
else; check status; 
if no error; give buffer to activating handler; 

turn eff error flag; 

exit to commutator; 
else; handle error; 
if first tiie or EOF* send error command to 

activating handler; 

exit to commutator; 
else; do start timer; 

put beffer back on handler's queue; 

exit to commutator; 

RFTAP: timer appendage* 

establish addressing for local storage; 

issue release IOC call to release request gueue; 

return; 
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I. Product Identification 

Product Abstract 

This driver is designed fcr use with the HP 2000 ACCESS system 
to support the HP1 2989A. reader/punch/interpreter subsystem. The 
module is written in a serially reusable manner in order to 
support multiple (up to 7) reader/punch/interpreters. 

II. Design Overview 

2®sign Assumptions 

this driver assumes . a 2100 or 21MX series comput«r and the 
HP2000 ACCESS Firmware Option (13206A cr 13207A). 

CesiSIi Summary 

The reader/punch/inter preter driver consists of two separate 
modules, D.340 and D.34C. The D. 340 module contains the 
initiator, continuator, and power recovery entry points and all 
potentially volitile local storage for a given 
reader/punch/inter preter* Cnly this module must be replicated to 
support additional devices. The other module, D.34C, certains the 
actual driver code and is used as a subroutine by all copies of 
D.340. 

The D.34 driver is a read/write driver and will support the 
following functions: 

Clear- any card in the visible wait station' is ejected 
to the selected stacker and the device status is 
cleared. 

Read- Cards may be read in ASCII, EBCDIC or column 
binary format. 

Write- cards may be punched in Hollerith or column 

binary format. ASCII data may be printed on the 

top edge cf the card. The. print data may be 

different frcir the punch data. 

Control- • control operations supported are 
-feed a card frcm selected hopper 
-set stacker select mode 
-set stacker overflow mode 
-clear the visible wait station by ejecting 
card to selected stacker. 
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The power recovery routine allows for the proper termination 
of any read/write operations that were active at the time cf power 
failure. 

The error handling section provides for the detection cf 
empty hopper, full stacker, data conversion errors, pick fail, 
eject fail, cr not ready conditions. The occurrance of a •::• 
sequence in columns 1 and 2 cf a card is treated as end cf file. 

2£§i2U_Ac.£roach 

The driver is written in a serially reusable manner. That 
is, one copy of D. 34C serves multiple ccpies of D. 340. Access to 
local data storage for each device is through an indirect pointer 
list. Interrupts from multiple devices are queued and handled 
serially by the driver. 

D.34C contains code for the initiator section (D.34C), the 
continuator section (I.34C) and the power recovery section 
(P.34C). In the initiator section, the call parameters are 
analyzed, initial conditions are established, and a read, write, 
or control operation may be initiated. Because the initiator 
section may be entered from case level programming (.IOC.) or the 
continuator section (.BOFR), the initiator section is entirely 
disabled. 

I.34C, the continuator section, consists of three parts. The 
first part, which runs disab3ed, queues the interrupt for service. 
If this interrupt is the first to be queued, the second part is 
entered. Otherwise, an exit is made immediately. 

In the second segment cf I.34C, the interrupt is handled. A 
detailed description of the interrupt handling process is given 
belcw. When interrupt service is completed, the third segment is 
entered. 

In the third segment, which also runs disabled, -the storage 
block just serviced is removed from the queue. If more storage 
blocks remain in the queue, the second segment is entered again. 
Otherwise, an exit is made from th* original interrupt. 

The P.34C section is entered for each 

reader/punch/interpreter device at power recovery time. If the 

assocaited 1.340 section was active, D.04? is entered to restore 

the condition. If the intarmpt section was not active, but an 
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operation had been scheduled, 
I.34C to effect recovery. 

•3°.£iJl£ Derail 



an interrupt is forced to cause 



The following define the indirect pointers in D. 34C used to 
access the local data in D.340. 



EQTA 

BUFF 

BDUFF 

NLEN 

LNGTH 

PPOFF 

IOREQ 

FLAGS 



CHAR 
STCL 
STCH 
CLCL 
CLCH 
LIAL 
LIAH 
OTAL 
OTBH 
PSTAT 



EQT address 
buffer addr 
byte addr*s 
negative re 
original re 
print/punch 
I/O request 
driver flag 
bit 15 
14 



dri 
sta 
=0 
=1 
13 wri 
12 fee 
11 fir 
10-8 not 
7 inh 
6-2 not 
0-1 rea 
= 
= 1 
=2 
first input 
set control 
set control 
clear contr 
clear contr 
LIA ins true 
LIA instruc 
OTA instruc 
OTB instruc 
pseudo stat 
bit 15 
14 
8 
7 




ess 

s cf buffer 

ad/write length 

guest length 
buffer offset 
word 

s 

ver busy 

cker node 

stacker select mode 

stacker overflow mode 

te operation started 

d after write 

st input character read 
u se d 

ibit input 
used 

c/punch mode 

ASCII/Hollerith 

Column Binary 

EBCDIC 
character 

instruction for low select code 
instruction for high select code 

cl instruction for low select code 

cl instruction for high select code 

ticn for lew select code 

tion for high selact code 

ticn for low select code 

ticn for high select code 

us wcrd 
not ready condition 
stacker full 
hopper 1 empty 
hopper 2 empty 
card in wait station 



POPT 
SSTC 



print/punch options fcr write request 

STC subroutine with power/fail instruction 
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The following define data specific to D. 3 4C 

SQADR Queue for SIC instructions 

IQADR Queue for interrupts 

TEMPI Temporary 

TEMP2 storage 

TEMP3 for continuatcr Section 

The following "structured" description provides internal 
nodule detail* 

D.340: entry point for initiator section. 
JSB to common initiator code D.34C; 

The following modules nake up the initiator section of the 
common code. 

D. 3UC: entry into initiator section of common code, 
disable interupts; save EQT address; 
save EQT pointers; 

establish addressing for local data; 
establish r«al return address and 
save at D.34; 
get user request code; 
if clear, enter CLEAR routine; 
if driver already busy, then; 
set bit 15 in B-reg; 
enter REJCT; 

set to ignore ict on low channel; 
save reguast code status; 
if read request, enter READ routine; 
if write request, enter WRITE routine; 
if control reguest, enter CMTRL routine; 
indicate request code reject (B=0) ; 



REJCT: indicate re :ect return (A=1); 
enable interrupt; 
exit; 

READ: routine to start the read operation. 

JSB to RHSTF to set up initial conditions; 

zero the transmission log; 

if device iitput buffer is full, 

set to handle interrupts on data channel; 

use LIA subroutine to read first character; 

save at PRCHC; 

indicate character. read in driver flags; 

.issue STC,C on low channel; 
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WRITE: 



RHSTR: 



CNTRL: 



IMRET: 



take normal exit (NEXIT) ; 
use FEED subroutine to feed card; 

if «-1 return frcm FEED, take not ready exit (NREDY) 
if +2 retuEE, take normal exit (NEXIT) 



routine to 
use RWSTR s 
copy write 
case immeJi 
if punch re 
if print re 
if separate 
save print/ 
if card in 
set D 
indie 
skip 
clear B; 
use FEED su 
if *^ retur 
if +2 retur 



initiate punch or print operation. 

ubroutine to set up initial conditions; 

length to transmission log in 

ate return; 

cuest, set to enable punch; 

guest, set to enable print; 

print/punch data, set SPD bit, 
punch options; 
*ait station, then; 
-reg with print/punch options; 
ate write started in driver flags; 
Eext instruction; 

trcutine to start operation; 
n, take not ready exit (IMRET) . 
n, take normal exit (NEXIT). 



subroutine to set up initial conditions 
for read or write operations, 
get buffer address and save (RPBUF) ; 
get buffer Jength and save (RPLEN) ; 
negate and save for count (RPLNG) ; 
get 10 request word and save (RPREQ) ; 
make driver busy (EQT and driver flags) : 
return; 



routine to 


get 


, subfunc 


if 


feed reg 




JSB t 




take 




skip 


if 


clear wo 




enter 




take 




take 


if 


set stic 




set i 


if 


set stac 




set i 


set 


. bit 15 


ena 


ble inte 


exit; 



handle cent 
tion code; 
test then; 
c FEED subr 
r.ct ready e 
return--tak 
ik station 
EJECT subr 
not ready e 
noriral exit 
ksr select 
ndicator in 
ker cverflc 
ndicator in 
in A-reg, c 
rrupts; 



rol requests. 



outine; 

xit (IMRET) ; 

e normal exit (NEXIT) 

request, then; 

outine; 

xit (IMRET) ; 

(NEXIT) ; 
mode, then; 

driver flags; 
w mode, then ; 

driver flags; 
lear B=reg; 
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NEXITs clear A-reg; 

enable interrupts; 
exit; 

CLEAR: routine to handle clear requests, 

zero transiissicn log; 

use STATS subroutine to get device status; 
if +1 return because not ready, then; 

issue CIt to both channels; 

clear status in EQT; 

clear device flags; 

exit via D.34; 
use EJECT subroutine to eject card; 
exit via D.34; 
exit via D. 34; 

EJECT: subroutine tc v : k the visible vait station; 

set to inhibit input en feed operations; 
clear B-reg ; 
enter FEED subroutine; 
return; 
increment return address; return; 

The following are subrcutines used by both the initiator and 
continuator sections of the common code. 



FEED: 



subroutine 
entered, th 
options. A 
the device 
plus two re 
enter subro 
input buffe 
clear buffe 
enter STATS 
return if n 
if stacker 
if selected 
set command 
mergi 
selec 
output word 
enter FILL 
output buff 
if in initi 
else queue 
increment r 
return; 



Otherwise, a 

clear device 

data channel; 
check status; 



tc feed a card. When 

e B-reg' contains print/punch 

plus one return is made if 
is not ready, 
turn is made, 
utine MTINB to 
t; 
£ full flag in 

subroutine to 
ct ready; 
full, then return; 

hepper is empty, then return; 

channel control word by 
Eg B-reg with hopper/stacker 
tion bits in 10 request; 

tc command, channel; 
subroutine to fill a waiting 
er if necessary; 
atcr section, then issue STC; 
the STC request; 
eturn address; 
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MTINB: 
EAT: 



LIA: 
LIAL: 



FILL: 
FLUP: 



CKRDY: 



subroutine to empty the device input buffer. 

use LIA subroutine to read character; 

if buffer enpty, return; 

JHP to EAT to empty the buffer; 

subroutine tc read data channel. 

read the low select channel; 

if buffer eirpty f return; 

if data not ready, JMP to LIAL; 

else issue STC to get more data; 

issue CLC tc low select channel; 

return; 

subroutine to fill a waiting output buffer. 

indicate first time through; 

enter CKRDY subroutine to see if device is ready 

fcr command.; 

return to caller on plus one return; 

read data channel; 

if device flag is set, 

or first tiae through; 

issue STC tc fill buffer; 

JWP to FLUP tc repeat; 

subroutine to check the ready for command bit. 
read the cosmand channel; 

if not ready, then increment return address; 
else return; 



STATS 



SKHIS: 



subroutine 
read low se 
if status n 
if input ch 

indie 
if read che 

indie 
if hopper 1 

indie 
if output c 

indie 
if stacker 

indie 
save low ch 
read high s 
if hopper 2 

indie 
if card in 

indie 



to check and update the 

lect channel; 

ct available then check 

eck, then; 

ate not ready condition; 

ck, then; 

ate data error condition; 

empty, then; 
ate hopper 1 empty; 
heck, then; 

ate not ready condition; 
full, then; 

ate not ready condition; 
annel status; 
elect channel; 

empty, then; 
ate hopper 2 empty 
wait station, then; 
ate card in wait station; 



device status; 
high (CKHIS) ; 
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if not ready, then; 

indicate not ready; 
merge low and high status; 
update EQT status word; 

if no not ready condition, then increment return 
address ; 
return; 

The following routines sake up the continuator 
section of D.34. 

I. 340: entry point for ccntinuator section. 

JSB to common continuator code (I.3 4C); 

I.34C: entry point into continuator section of common code, 
disable interrupts; *»*.vo registers; 
indicate interrupt received in local data; 
queue the interrupt; 
if not first on queue, then; 

get return address; 

restore registers; 

exit with enable; 
else set up returc address for exit; 
set switch in FEED and LIA subroutines to 
indicate continuator in control; 

I. GO establish addressing for local data; 
establish EQT poitters; 
enable interrupts; 

set for no interrupts on data channel; 
get IC reguest word; 
if completion fron CLEAR, 

go to LEND; 
if completion frcs CNTRL, 

go to LEND; 
if completion froa WRITE, 

go to IWRIT; 
else completion fics READ; 

IREAD: handle read interrupt. 

if read column birary requested, then; 
IRCBI: if first character already in, 

use subroutine WRISZ to store character 

and increment counters; 
IRCBL: use CfLIA subroutine to read character; 

use WRISZ subroutine to store character 

and increment counters; 

JMP IFCBL to loop until done; 
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if ASCII read requested, then 

set ASCII ccnversion table address; 

enter IRASC routine; 
if EBCDIC read reguested, then 

set EBCDIC ccnversion table address; 

enter IRASC rcutine; 

IRASC: subroutine to rsad ASCII or EBCDIC, 
change buffer add tc byte address; 
if first character already read, skip 
over reading character; 

IRASL; use subroutine CRLIA to read character; 

use ACRT or ECVRT subroutine to convert character; 

use BRISZ subroutine to store character 

and increment counters; 

JMP IRASL to loop until done; 

IREND: routine to complete read. 

use MTINB to empty buffer if necessary; 

put # of characters less trailing blanks in transmission log; 

enter I.BUFR; 

go to LEND; 

IWRIT: routine to handle write interrupt, 
if feed before write, then; 

set print/punch options (PPOPT) ; 

enter FEED subroutine to start write; 

go to LEND ; 
if «rite completion, then 

set transmission log; 

set EQT status; 

go to .BUFR tc complete writa ; 

go to LEND ; 
else set temporary counter to -80 for punch operation; 
if punch binary request, then 

set print, buffer offset to -80; 

get buffer address; 

lead data wcrd; 

output to device using OTA subroutine; 

increment buffer printer; 

use cwisz subroutine to count down; 

lcop until dene; 
else for ASCII punch; 

set print buffer offset to -4 1; 

convert buffer address to byte address; 

get character from buffer; 

use CATCH subroutine to convert character; 
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I.CND: 
I. EMC: 



I. DON 



output character; 

use CWISZ to count down; 

loop until done; 

sake driver not busy; clear driver flags; 

disable system; 

remove storage blcck from queue; 

if queue not empty, go to I. GO; 

else; dequeue pending STC; 

if any on STC queue, then; 

issue the SIC; 

check for acre entries on STC queue; 
else; 

restore requests; 
exit with enable; 
end 



The following subroutines are used by the read 
routines* 



CHLIA: 



BEISZ 



HRISZ 



ACVHT: 



ECVRT: 



subroutine to get character from device input buffer* 

use LIA subroutine to read character; 

if data present, then; 

return; 

else; enter IHEND to complete read; 

routine tc store character and increment counters* 
store the byte in user buffer; 
increment character count; 
return; 

routine to store word and increment counters* 

store word in user buffer; 

increment buffer address; 

increment character count; 

return; 

subroutine converts to ASCII • 

if blank, load .ASCII blank; return 

else convert card cclumn punch to ASCII; 

if illegal punch, then enter IRDCK; 

indicate significant character; 

return; 

subroutine converts column binary to EBCDIC, 
if blank, load EBCDIC blank; return; 
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else convert to EBCDIC; 

if illegal, then enter IRDCK5 

count significant character; 

return; 

IRDCK: use BTINB to clear device input buffer; 
set status in EQT ; 
GO TO I.BFR; 

The following subroutines are used by the write routines 

CWISZ: subroutine to court dcwn on punching, 
increment count of characters; 
count down using vrite length; 
when done, return plus one; else return plus 2; 

OTA:. subroutine to output character, 
output character to buffer; 
read data channel; 
if not ready, loop until ready; 
else execute STC instruction; 
return; 

CATOH: subroutine to convert ASCII to Hollerith, 
check for non-valid character; 
if not valid, set to output blank; 
else get Hollerith from table; 
return; 

WFILL: routine entered at end of punch. 

fill up output buffer if necessary; 

if separate print data reguested, then; 

get buffer address; 

add print data cffset; 

convert to tyte address; 

set temporary counter to -80; - 

output byte ; 

loop on output until dene; 
disable interrupt; 
indicate feed after write; 
go to LEND; 

The following is a description of the power 
recovery routine. 

P.340 entry point for pewer recovery routine 

JSB to P^ 34C; 
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P.3UC common code for pcwer recovery routine 

get and save return address; 

get address of interrupt entry point and save; 
get address os STC instruction and save; 
get address of STC flag and save; 
if interrupt section was active, then 

enter D.04? tc restore condition; 

exit; 
if STC instruction was executed, then 

issue STC instruction to cause interupt 
exit; 

III. Design Structures 
IHJs§l£§£S D esc ri ptio n 

Cleay 

Any current operation is aborted. Any card in the visible 
wait station is ejected to tie selected stacker. Device status 
bits are cleared -and the driver enters an idle state. 

JSB .IOC. 

OCT OOOOxx xx=logical unit number 

Read 

A card is read and transferred to the supplied buffer. 
Optional data conversion may occur. If the device read tuffer is 
full (card was fed by previcus operation) , no card moveaent takes 
place. Otherwise a card is fed froa the selected hopper. If the 
device read buffer is sapty, but a card is in the visible wait 
station, it will be ejected to the selected stacker when the next 
card is fed. 

JSB . IOC 

OCT parameter word 

JMP REJCT 

DZF BUPFR 

The parameter *ord is defined as follows: 

Bit 15 queued request 

14-12 function 

=1 read 
11 stacker select 

=0 stacker 1 



4-73 



=1 stacker 2 
10 hopper select 

=0 hopper 1 

=1 hopper 2 
9-8 not used 
7-6 read mode 

= ASCII 

=1 column binary 

=2 EBCDIC 
5-0 unit reference number 

Data is punched and/or printed on a card. The punch data may 
be Hollerith or column binary fcrmat. The print data must be 
ASCII format* The print/punch data may be the same or different 
data* 

JSB .IOC 

OCT parameter word 

JMP REJCT 

DEF BUFFR 

The parameter word is defined as follows: 

bits 15 queued request 

• 1U-12 Function 

= 2 write 
11 stacker select 

= stacker 1 

= 1 stacker 2 
10 hopper select 

=0 hopper 1 

= 1 hopper 2 
9 not used 
8-7 punch/print options 

=00 punch, print same data 

=01 punch only 

=10 print orly 

=11 punch, print separate data 
6 punch mode 

=0 Hollerith 

=1 column binary 
5-0 logical unit number 

Control 

The control request is used to perform special 
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functions and set device modes. 

JSB .IOC* 

OCT parameter word 

JMP REJCT 

The parameter word is defined as follows: 

bit 15 queued request 
14-12 function 

=3 control v 
11 stacker select 
=0 stacker 1 
=1 stacker 2 
10 hopper select 
=0 hopper 1 
=1 hopper 2 
9 not used 
8-6 subfunction 

*0 feed card from selected hopper 
=1 enable stacker control mode 
a 2 enable stacker overflow mode 
■3 clear visible wait station 
5-0 logical unit number 

•§la£j2£ Infor.amt^on 

On a read operation, the transmission log contains the number 
of card columns read less trailing blanks. On a write operation, 
the transmission log contains the number of characters printed 
and/or punched. 

The status word is defined as fellows: 

bits 14 error 

2-0 *C no error 

=1 not ready condition 

hopper enpty 

stacker full 

pick fail 

eject fail 
-2 daifa conversion error on read 
= 3 power fail 
=7 end of file 
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Serial Link Terminal Handler 

Description and Function 

The Serial Link Terminal Handler is responsible for normal 
flow of input, output and control requests to the Serial Link Terminals 
and notification of its caller of error and completion conditions. 

This handler is written in a serially-reusable manner, 
in order to simplify the addition of new terminals to the system, the 
handler is composed of two separate and distinct modules. The first 
module contains the unique entry points and local data storage for a 
given terminal, so that when another terminal is added only this code 
is replicated. The second module is the serially-reusable code used 
by all copies. of the first module. 

This handler adheres to the defined level-2 level-3 protocol. 

Interfacing 

L.TH accepts these work entry commands : 

START - received from a level-2 handler in a control buffer 
It activates the handler. 

WRITE - received from a level-2 handler in a data buffer. Contains 
a line of characters to be output to a terminal. 

READ - received from a level-2 handler in a data buffer. Causes 
LTH to obtain data or information from a terminal. 

STOP - received from a level-2 handler in a control buffer. Causes 
the handler to begin termination processing. 

ALLOCATED BUFFERS - received from Buffer Manager. These are 

buffers which were previously requested but not available 
at the time of the request. 

START TIMED RETRIES - received from a level-2 handler in response 
to error notifications. Causes the handler to restart the 
erroneous operation after a cause, 

PUiUiK - received from a level-2 hanaler in a control buffer. 

Causes all outstandinq reauests to be purged and starts 
termination processing. 
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CONTROL OPERATIONS - received from level-2 handler in a control 
buffer. It is used to initiate special control operations 
on the terminal. 

LTH returns these commands to its activator : 

NOP - an allocated buffer, a completed write or a purged data 
buffer is being returned. 

WRITE - a completed read is being returned. 

STOP - the received stop command is returned following the return 
of all data buffers and de-activation. 

ERROR - a notification that an error has occurred is sent. 
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Local Data structures 



The buffer in the input queue are defined as follows : 

START command : 

BCW-2 Bits 13-8 stream identifier 

3-0 command code (3) 

BCW-3 Bits 14-0 activating handler queue name 

BCW-7 Bits 15-0 Duffer length 

Data word-1 number of buffers (1) 

WRITE/HEAD commands : 

BCw-2 bits 3-0 commana code (1 or 2) 

BCW-7 bits 15-0 length of data in characters 

CONTROL commands : 

BCW-2 bits 3-0 command code (8) 

Data word-1 control function code 

The buffers in tne output queue are defined as follows : 

WRITE type : 

BCW-2 Bits 13-8 stream identifier 

3-0 command code (1) 

BCW-7 Bits 15-0 number of characters in buffer 

BCW-8 Bits lb-2 unused 

1-0 no error (0) 

ERROR type : 

BCW-2 Bits 13-8 stream identifier 

3-0 commana code (6) 

BCW-8 Bits 1-0 error type 

NOP type : 

BCW-2 Bits 13-8 stream identifier 

3-0 command code (0) 

stop type : 

BCW-2 Bits 13-8 stream identifier 

3-0 command code (4) 
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These symbolic pointers to local data are used 



TERMA 
TALKA 



STATU - 



LIGHT 
CON.FG 



LUN 

QUENM 

AHQUE 

SID 

FLAGS 



BYTEI - 



TCTBF 
OUKFR 
STOfB 
TUE 



address of 
address of 
bits 15-14 
13-5 
4-0 
status of 
bits 15 
14 
13-3 
2-1 




terminal on .Serial. Link 
current input unit 
: not used 

: terminating mode of special keys 
: input unit address 
terminal 
: terminal busy 

: power fail occured on request 
: not used 

: input completion type 
: service requested at terminal 
state of prompting lights on terminal's display 
configuration options 
bits 15-9 : not used 

8 : HPIB istrument option present 
7 : CP T unit state 
6 : CF 'Mtr' -. ?■: « s ■ 
5 : not ";>eu 

4 : Card/Badge reader option present 
3 : Printer unit state 
2. : Printer option present 
1 : Display unit state 
.IQC. logical unit number 
name of associated work queue 
name of level-2 activating handler 
stream identifier 
internal logic conditions 



bits 



15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

3 

2 

1 



(REQON) request in progress 

CERFLG) error' detected during command 

(CTBEX) control expected back 

CINPEX) read data expected 

(PRIEX) print of data expected 

CRDIEX) read status information expected 

CSTDUN) status request in progress 

CSRION) service request identification on 

(PFAIIL) power failed during command 

(IBCEX) HPIB command expected 

(tlTEX) light numbers expected 

(RESTO) environment being restored 

(AUTRD) automatic read selection in effect 

(PUGRQ) termination procedure in progress 

status byte 

type of information (address or status) 




information 
bits 15 : 

14-6 : not used 
5-0 : information part (address of unit or status) 
control buffer address for use in delegation of control 
head of wait queue 
tail of. wait queue 
timer aueue elements 
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Algorithm 

LTH has four entry points : 

LTHHI : "handier initialization" : invoked by system initialization 
module. It issues a call to FIND routine for its own 
oueue name. The queue name is retained in QUENM and will 
be needed for issueing GETQ requests, 

LTHHP : "handler priming" : receives control from System Dispatcher 
when primed by system Queue Manager. PADDS is used to 
generate a list of indirect addresses for .access to the 
local storage area. Initially the handler is in an idle 
state. It is removed from this state by being 
primed with a START command containing the queue name 
of the level-2 activating handler. All other commands 
are accepted following the START. PURGE, START-TIMEO- 
PETRY and ALLOCATED BUFFER commands are processed as soon 
as they are received. READ, WRITE, CONTROL and STOP 
commands are queued on the handler local wait queue. 
If the wait queue is empty upon reception of a command 
that command is immediately processed. LTH stays in the 
active state until a STOP or a PURGE command is processed. 
Then it returns to its idle state and a new START command 
is needed to re-activate it. 

LTH handles one queue entry at a time wWfn it is primed. 
The queue entries are processed as follows : 

START : the activator's queue name and the stream 

identifier are saved in AHQUE and SID respectively. 
The rest of the local storage area is initialized. 
The START buffer is returned to the Buffer Manager 
and one data buffer of appropriate size is 
requested from the Buffer Manager. 
Once obtained this buffer is used to issue an 
IFC call to .IOC. which causes the driver to 
initialize the terminal. 

WRITE : the data in the buffer is interpreted according 
to the value of selected bits in FLAGS : 

a) if bit-3 is set the buffer contains a list of 
light numbers. The appropriate sequence of 
requests to .IOC. is issued to correctly 
position the prompting lights. LIGHT is updated 
to reflect the state of eacn light on the display. 

d) it oit-4 is set. tne buffer contains a list of 
special function keys. The appropriate sequence 
of requests to .IOC. is issued to correctly set 
the terminating mode of the keys. SFKS is 
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updated to reflect the mode of each special 
function key. 

c) if bit-6 is set the buffer contains an HPIB 
message. That message will be decoded and emulated 
according to its meaning. 

d) otherwise the buffer contains ASCII characters. 
An .IOC. call is issued to cause the driver to 
print a line of characters on the terminal. 

READ : if an input unit is defined, that is if bits 4-0 
TALKA word are not all set to one a read request 
is issued to enable the current input unit on 
the terminal and start an input operation. 
If no input unit is defined the read buffer is 
used to issue a WAIT on SRQ request to IOC. 
Then when the SRQ line goes LOW the address 
of the input unit will be determined and a 
normal read issued to this unit. 

STOP : the data buffer containing the command is used 
to issue an IFC call to .IOC. which causes the 
driver to reset the terminal to its initial state. 
PUGRQ condition is set in FLAGS and any pending 
operation is cancelled. 

ALLOCATEQ BUFFER : the buffer may be a control buffer 

or a data buffer. The control buffer is used to 
send an error notification to the activator. The 
data buffer is used to issue an IFC call to 
.IOC. to cause the driver to initialize the 
terminal. Subsequently the buffer is made 
interlocked. The stream identifier and NOP command 
are placed in BCW2 and it is sent to the activator, 

START TIMED RETRY : a timer is started and the buffer is 

freed. When the timer finally exits, the operation 
at the top of the wait queue is re-initiated. 

PURGE : an IFC call is issued to .IOC. which causes the 
driver to reset the terminal to its initial 
state. PUGRQ .condition is set In FLAGS. 

CONTROL : it is used to perform special operations 

on the terminal and its optional units. Those 
special operations are emulated as a series of 
write requests to the associated driver. 
Control functions 71 to 81 are related to the 
display, keyboard, printer, badge and CRT units 
of a terminal. At the end of the actual operation 
the control buffer is released by this handler. 
Control function 70 is related to instruments 
connected to a terminal via its internal HPIB. 
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Once a control request with code 70 has been 
received the normal control functions (codes 71 
to 81) become ineffective. The control buffer is 
kept in TCTBF word for use in case of the HPID 
"delegate control" command. 

The CALL routine is invoked whenever a call to .IOC. is 

necessary. It prepares the required code sequence and 

saves in word BCW5 the address of the local storage area 

associated with this terminal. 

The IOCMD and IOCM2 routines format special command 

write requests to the driver (pure riP£6 commands are issued 

that way). 
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LTHHC : "handler I/O completion" : receives control from System 
Dispatcher when scheduled read or write requests have 
comoleted. 

The address of local data storage is found in word BCW7 
of the returned buffer. PADDS routine is used then to 
generate the correct pointers to the local area associated 
with the terminal. If PUGRQ condition holds, that is if 
a PURGE command has been previously. received, the buffer 
is returned to level-2 handler as NOP (if a data buffer) 
or freed (if a control buffer). 

The following error detection/correction procedure is used 
when the error bit is set by the driver : 

- if ERFLG is already on, that is if an error was 
detected on that same operation during the 
previous attempt, a timer is started for 1 second 
and the request is requeued at the head of the 
wait queue. 

- otherwise ERFLG condition is set and a control 
buffer is requested to notify the level-2 handler 
of a type-2 or type-3 error condition. The buffer 
is requeued at the top of the wait queue and will 
be reactivated when a timed retry is scheduled. 

If no error has oceured the command type is analysed to 
determine the next action to undertake. One of the 
following nay take place : 

- the operation has not completed and the buffer 
is used to send the next request to the driver. 

- the operation has completed and the data buffer 
is returned as NOP (if a WRITE command), as 
WRITE (if a READ command)) or as STOP (if a 
STOP command), while the control buffer is freed 
by this handler. If PUGRQ. condition holds the 
wait queue is emptied and all the buffers returned 
to the system. 

If the wait queue is empty control is passed to 
the System Dispatcher. Otherwise, the top entry 
of the wait queue is obtained and passed to LTHHP 
section for processing. 

r.THT : "timer-expiration" section : receives control from the 
time base generator handler when a timed pause expires 
(for operation retries following not ready states). 
Upon entry the content of the A register (address of timer 
block) is used to generate the pointers to the local area 
associated with tnis terminal. 

The buffer at tne top of the wait aueue is obtained and 
oassed to LT'.ui? for re-processing. 
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Special cases 

1 ) Restarting a Read operation through the SRQ alarm button. 

When the presence of an SRQ is sensed at the end of a Read request 
the following takes place : 

- the SRQ is acknowledged 

- the terminal is restored to tne state recorded in 
handler's local tables (lights, keys, input/output units) 

- the read operation is automatically restarted. 

If the request" could not be acknowledged at the beginning of the 
procedure then a type-3 error is notified (operator intervention). 

2) Power fail condition. 

The handler receives in STATU an indication of the occurence of power- 
failures (it records this condition in PFAIL flag); 

If at the end of an operation PFAIL condition holds, the following 
takes place : 

- the system is notified of an error if the operation was 
a read since one character may have been lost. 

- the operation is retried if it was a WRITE of prompting 
light codes. 

- the operation terminates normally in all other cases. 

3) Instruments in use. 

When a control function 70 has been executed the terminal is viewed 

as a set of HPIB compatible instruments (keyboard is an input unit with 

address 29, display is an output unit tfith address 29, ). 

No recovery procedure is attempted in this case as the handler does 
not keep track of the state of the complete HPIB. The SRQ condition 
is no longer interpreted as an input restart indication. 
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hp 2000 access r/o processor 

base: design specifications 

d.53 serial link controller driver 



I, Product identification. 



1.1 Product abstract. 



The 0.53. Serial Link Controller driver is designed for use 
with the HP2000 Access System. It provides an interface for 
input/output operations between an HP21MX series computer 
and 3070 data collection terminals connected to a 40280A 
controller via a Serial Link. 

The D.53 driver will nandle up to 8 Serial Link Controllers 
simultaneously whith up to 31 terminals on each Serial Link 
(the system will limit to 31 the total number of 3070 terminals 
configured in the I/O processor). Transmission rates between 
25 and 250 characters are supported by each controller. 



II. Design overview. 



11. 1 Design assumptions. 

The driver module assumes a 21MX series computer and requires 
the HP2000 Access 1/0 processor microcode. 

11.2 Design summary. 

The complete driver consists of two distinct modules (D.530 
and D.53CJ. The D.530 defines the actual driver initiator, 
continuator and power fail recovery entry points associated 
with any given Serial Link Controller. This is the only 
module which must be replicated to support multiole controllers 
It includes all data associated with a specific controller 
such as related I/O instructions/ list pointers....... 

The D.53C which contains the actual code is used by all copies 
of D.530 to drive the 3070 terminals controlled by a Serial 
Link Controller. 
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II. 3 Design approach. 

11. 3.1 Controller logic. 

Although the Serial Link Controller is physically a single 

I/O board, it may be viewed as a multiplexer for up to 31 data 

collection terminals of the 3070 family. 

The controller uses a polling technique to communicate 

with the terminals. A polling cycle consists of a series 

of elementary messages conforming to the Serial Link Protocol 

and constructed from a table- of informations passed by the 

driver before starting a cycle. The format of an information 

word is described in Table-l. 

Upon the end of the cycle the controller will interrupt the 

CPU if one of the two following conditions holds : 

1) an interrupt has been requested by the driver 

2) at least one operation programmed in the cycle has 
completed (either a character has been accepted or 
one character has been received). 

If none of the conditions is fulfilled the controller 
automatically reoeats the cycle. 

1 1. 3. 2 Driver logic. 

D.53c is written in a serially reusable manner and serves 

all Serial Lin< Controllers. 

It accesses a given D.530 storage block through a series of 

indirect pointers. In addition it has access to the calling 

handler storage block wnere it finds information about a 

specific terminal. D.53C finds in BCa-5 the address of the 

data block associated with the terminal to which the request 

is directed. The structure of the Dart of the data block that 

D.53C accesses has Deen detailed in Table-2. 

For each controller the driver maintains a linked list of 

data blocks called the Active Terminals List. The head of 

the list is part of that controller local data structure C.ACTQ) 

while the elements are the calling handlers data blocks. 

Each time a request, is accepted by the driver, trie calling 

handler data block is inserted into the Active List of that 

controller according to the terminal number (contained in 

TERM A word). 

Normally the driver will reject a request if the previous one 

has not completed. The only exception to that rule is the 

"initialize terminal" request which will cause the current request 

to be anorted. 

Un'on request completion by the driver, the data block is unlinked 

from the Active List. 
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II. 3. 3 Driver algorithm description, 

bike all BCS drivers the Serial Link Controiler driver has an 
initiator section (1.53C), a continuator section (D.53C), a 
power-fail/restart control section (P.53C) and a time out exit 
CT.53C). 

The initiator section is responsible for converting a requested 

operation into appropriate actions. 

The following prologue takes place at request initiation in D.53C s 

1) validity of request is checked 

2) handler data block is located, initialized and linked 
to the Active List 

3) if the Controller is already active an interrupt is requested 
at the end of the current polling cycle and step 4 is skipped. 

4) if the Controller is not active the table of information 

is constructed, passed to the controller which starts a cycle. 

The continuator section is primarily an interrupt handler and 
event complete processor. The following procedure is activated 
upon acknowledgment of an interrupt from a controller : 

1) the table of informations is obtained from the interrupting 
controller 

2) for each terminal present in the Active List the op-code and 
the step-number are used to determine the next action i.e s 

- either a transition to the next step takes place and the 
next element of the information table is prepared 

- or the request is completed if it has reached its final step 

3) if not all terminals have completed their requests the table 
ot informations prepared in step 2 is used to start the next 
cycle. 

If another interrupt occurs while this section is in use, that 
interrupt is queued and processed only when the active interrupt 
is completed. 

The power fail recovery section receives control from 0.04 after 
power is restored to the CPU following a power failure. 
P.53C is responsible for restoring the controller interface 
board to the status it was in when power failed. 
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Ill, Design Structures. 



III.l Handler -— > Driver Interface structure. 

The handler and the driver levels of software interface thru 
calls to .IOC. The following functions are issued by the handler 

Function Sub-function Operation 



01 00 Normal read of data 

01 Transparent read of data 

02 00 Normal write of data 

01 Terminal initialization 

02 Special write of HPIB commands 

03 Remote Control Enabling 

04 Remote Control Disabling 

05 Service Request Condition Monitoring 

06 Service Request Identification 

III. 2 Driver ---> Handler interface structure. 

The driver returns requests to the handler level thru calls to 
.BUFR.. The transmission log information is passed in that handler 
data block (BUFL word), while the address of that data block is 
placed in BCW-7 of the returning buffer upon request completion. 

When a call is rejected the following return codes will appear 
in the A and B registers : 

1) A =1 , B =0 : if the request parameters are illegal 

(code, arguments... ) 

2) A =1 , B S100000 : if the terminal is busy executing the 

previous request. 
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£11. i Major functional modules. 

The D.53C driver is modular in its internal architecture. Each 
module may be viewed as a "function processor" (modules which are 
responsible for executinq a particular request) or as a "common 
module" (modules or subroutines which aid function processors). 

Normal Read 



Description and function 

Inouts a line of data from the current input unit of a terminal 
A line is considered terminated when a terminating character 
is received (LF, EOI line LOW, SRQ line LOW or any special 
function Key defined as a terminator in TALKA). 

Interface Description 

JSB .IOC . 

OCT 0100XX XX is the LU of a Controller 

JMP BEJCT Exit to reject address 

DtlF BUFFR Start address of buffer 

DEF LEN Lenqth of buffer in + characters 

The input unit is specified in TALKA bits 4-0. 

Alqorithm descriotion 

1. Put terminal in Input mode 

2. Enable input unit 

3. Incut characters until terminator detected 

4. Disable inout unit 

5. Update STATU, BuFL and return buffer. 
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Transparent Read 



Description and function 



Inputs characters from the HP1B, where it assumes that an input 
unit has been previously defined by a local controller. Request 
terminates upon-receipt of any normal terminating character, 

(whith ATN line LOW) or when buffer is full 



any command message 
Interface Description 



JSB 
OCT 
JMP 
DEF 
DEC 



IOC. 

0101XX 

REJCT 

BUFFR 

LEN 



XX is the LU for the Controller 
Exit to reject address 
Start address of buffer 
Length of buffer in + characters 



Algorithm Description 



1* Input characters until termination condition is detected 
2. Uodate STATU, SUFL and return buffer. 
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Normal Write 



Description and Function 

Sends characters to the output units of a terminal. The line 
of data is terminated by a LF character unless the buffer 
ends with a "<-" . 

Interface Description 



JSB 


• IUC. 


OCT 


0200XX 


JMP 


RKJCT 


DKF 


6UFFL 


DEC 


LEN 



XX is the LU of the Controller 
Exit to reject address 
Start address of buffer 
Length of data in + characters 



Algorithm Description 

1, Output characters in successive polling cycles 

2, End with LF (unless buffer terminated with "<-•■) 

3, Return buffer. 
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Initialize terminal 



Descriotion and Function 

Resets terminal to a well-defined initial state Cdisplay cleared, 
lights off). 

Interface Description 

JSR ,100. 

OCT 0201XX XX is the LU of the Controller 

JMP REJCT Exit to reject point 

DEF BUFFR Start address of buffer 

DEC LEN Not used 

Algorithm Description 

1. Send command message with IFC LOW 

2. Send command message witn IFC HIGH 

3. Send Device Clear command 

4. Return buffer. 

The following error detection procedure is used : 

- if terminal does not respond in steps 1, 2 or 3 the error 
bit is set in BCW-8 word 

- if terminal is busy, the current request is aborted and 
terminal initialization is started. 
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Command write 

Description and Function 

Sends HPIB command messacjes constructed from data passed in buffer 

Interface DescriDtion 



JSH .IOC. 

OCT 0202XX 

J MP REJCT 

DE? BUFFR 

DEC LEH 



XX is the LU of tne Controller 
Exit to reject address 
Start address of buffer 
Number of commands to send 



Commands are packed 2 per word in the buffer. 
Algorithm Description 

1. Format command messages by adding the ATM Pit to the data 
bytes and send them one per polling cycle 

2. Return buffer. 
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Remote Control Enaole 

Description and Function 

Sets terminal and associated instruments in remote control mode. 

Interface Description 

J SB .IOC. 

OCT 0203XX XX is the LU of the Controller 

JMP HE:JCT Exit to reject point 

DEF BUFFR Start address of buffer 

DEC LEN Mot used. 

Algorithm Description 

1. Set HEN toit in TERHA word, 

2. Send message with REN line LOW 

3. Return buffer. 

Disable Remote Control 



Description and Function 

Resets the terminal and its associated instruments in their local 
control mode. 

Interface Description 

JSB .IOC. 

OCT 0204XX XX is the LU of tne Controller 

JMP REJCT Exit to reject point 

DEF BUFFR Start address of buffer 

DEC LEft Not used 

Algorithm Description 

1. Zero out REN bit in TERMA word 

2. Sena command message with REN line HIGH 

3. Return buffer. 
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wait Until Service Requested 

Description and Function 

Watches the 3R0 line untii a unit on the terminal requests service 

Interface Description 



JSB .IOC. 

OCT 0205XX 

JMP REJCT 

DEF BUFFR 

DEC LEN 

Algorithm Description 



XX is the L-U of the Controller 
Exit to reject point 
Start address of buffer 
Not used 



1. Put terminal in input mode 

2. when SRQ line goes LOW return buffer. 

Identify Unit Requesting Service 



Description and function 

Determines which unit on the terminal requested service. Units 
to explore are tafcen from a list of units specified in the buffer 

Interface Description 



jsa 


.roc. 


OCT 


0206XX 


JMP 


REJCT 


DEF 


LUJFFR 


DEC 


LErt 



XX is the LU of the Controller 

Exit to reject point 

Start address of buffer 

Minus number of units to explore 



Algorithm Descriotion 



Disable all output units 
DisahLe all inout unitss 
Enable Serial Poll Procedure 
For each unit to be explored : 

4.1 En dole inout unit 

4.2 Read status from unit and store into buffer 

4.3 If SPQ bit set in status byte proceed witn step 5 
Disable all input units 
Disable Serial Poll Procedure 
ChecK whether SRQ gone 

w. 'Jo'^te SI A I'M word and return bur tier. 



1. 
2. 
3. 

4. 



5. 
6. 
7. 
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Get-New-Word Subroutine (GETNW) 

Description and function 

Builds a new *ord of the information table according to the 
contents of TfcJRMA word bit 15-6 (operation-code and step number) 
If the information table shows an input operation that has 
successfully completed, the character of the table is stored 
in the buffer. 

The step-number part of TEFMA word is updated and the current 
request is completed if the very last step has been reached. 
The structure of the step number information is described in 
Taole-3. 

Send-New-Word Subroutine (SEND) 
Descriotion and Function 




bit set to 0). 

The following error detection/correction procedure is used : 

1) if power failure occured just after the table has been sent, 
the transfer is restarted 

2) if the flag on the controller board is not comming back after 
the transfer, the power fail condition is checked as in 1. 

3) after the whole table has been sent, a time-out of 2 seconds 
is programmed to be sure to come-back even if power fails 
during the polling cycle and prevents the controller from 
interrupting. 
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Taole-l : Information word format. 

Driver > Controller. 

I. Terminal in input mode : 
Bits 



Interpretation 



15 



14 " 

13-12 

11-0 



Last word o £ table indicator (STOP) 

: last word 

1 : not the last word 
Not used 

00 tor input mode 
Not used 



2. Terminal in output mode : 

Bits Interpretation 



15 

1 \ 

13-12 

It 

10 

9 

8 

7-0 



Last word of table indicator 

Not used 

01 for output mode 

rt'C line state 

RKM line state 

KUI line, state 

ATN line state 

Data byte ..lines 



3. Terminal in idle mode : 
Bits 



Interpretation 



15 

14 
13 
12-0 



Last word of table indicator 

Not usea 

1 for idle mode 

Mot used 
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Controller > Driver. 

1. Terminal in input mode : 
bits 



Interpretation 



15 
14 



13-12 

11 

10 



9 
8 
7-0 



Last word of table indicator 
Transmission error flag : 

: transmission error detected 

1 : no error during transmission 
00 for input mode 

Not used 

Data byte present flag : 

: no data byte transmitted 

1 : valid data byte transmitted 
EOE line state if data present 
SHQ line state if no data present 
ATM line state if data present 
Not used if no data present 

Data byte if data present 
Not used if no data present 



2. Terminal in output mode : 



Bits 



Interpretation 



15 
14 



13-12 
11-0 



Last word of table indicator 
Data byte accented flag : 

: data byte not accepted 

1 : data byte accepted 
01 tor output, mode 

Message oeinq output Dy driver 



3. Terminal in idle state 



Bits 



Interpretation 



15 
11 

13-12 
11-0 



Last word of table indicator 

not used 

10 for idle mode 

Mot used. 
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Taoie-P : Data block structure. 



In U.53n (n=0 to 7 stands for controller number) module : 

.ACTQ - head of. Controller Active Terminals List 
PFLAG - power-fail/recovery indicator 

1 : recovery from power failure occurred during cycle 

: no power failure during cycle 

In LTxxH (xx stands for the terminal number) module : 

LINK - link in Active List 

T£RMA - terminal address specifications 

bits 4-0 : address of terminal on Serial Link 

5 : not used 

6 : start of request flag 

7 : REM line state (1 if LOW) 

11-8 : step reached in request execution 
15-12 : op-code of current operation 
TALKA - terminal input unit specifications : 

bits 4-0 : input unit number (37 if none) 

13-5 : special function keys mode indicators 

: key is not a terminator . 

1 : key is defined as a terminator 

14 : SRQ line terminating mode 

:. SRQ detection will not iend input 

1 : SRQ detection terminates input 

15 : not used 
STATU - terminal status word 

bits : service requested indicator (SRQ) 

.: SPQ line was rilGH 

1 : SRQ line was LUW 

2-1 : read request completion condition 

: normal completion 

1 : HPIB command message received (ATN L 

2 : buffer has been filled 

7-3 : unit identified as requesting service 
4-13 : hot used 

14 : power fail indicator : 

: power did not fail during request 

1 : potential error due to power failure 

15 : terminal busy indicator : 

: terminal not busy 

t : terminal busy executing a request 



4-99 



Table-3 



Step number information structure.! 



Bits 



Interpretation 



15 



14-13 



12-0 



Sourc 
: 



Modif 



o : 


l : 


2 : 


Bits 


apply 



e of next information word : 

computed by routine whose address is 

in bits 14-0 

word is encoded in remaining bits 
ications to apply to information word: 

not any modification 

merge with TALKA bits 4-0 

merge with BUFA word 
12-0 of the information word before 
ing the modifications. 
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SECTION V 
RJE 



HEWLETT-PACKARD 20O0 SYSTEM I/O PROCESSOR 



PJE 



CONTENTS 



1. D.62 

2. CIO 

3. SYN 

4. D.bO 

5. HI.,0 

6. HHO 

7. HMO 
b. 1110 

9. Appendix A 

10, CDC R.JE 



INTERCONNECT KIT DRIVER (RJE) 
CONSOLE INPUT/OUTPUT HANDLER 
SYNCHRONOUS COMMUNICATIONS HANDLER 
SYNCHRONOUS COMMUNICATIONS DRIVER 
HOST LIST DECOMPRESSION HANDLER 
HOST READER COMPRESSION HANDLER 
HOST MESSAGE DECOMPRESSION HANDLER 
HOST INQUIRE COMPRESSION HANDLER 
MUl.Ti LEAVING SPECIFICATIONS 



I. Introduction 

These Modifications serve as an extension of the D.61 Driver 
to allcw RJE Console operations. Functions implemented are READ, 
WRITE, and INIT. 

II. Design Overview 
^S^lSJl assum fit ions 

This driver is desicned to run in the HP2000 ACCESS 

environment. 

Design summary 

The modifications will allow the RJE Console feature to be 
implemented as a Buffered (Queued) I/O device. READ ASCII, WRITE 
ASCII, and INIT/CLEAR requests will be accepted. The processor- 
to-processor interface provides for operation synchronization with 
a "request- to- send," w permission-to-send w approach. 

Major modules include EEAD request processing, WRITE request 
processing, IN IT request processing, and SP command processors. 
All routines have access to the output routine OMTOM. 

III. Design Structures 

MJ2I f unc tional mcdulgs 

The INIT processor must be invoked to initialize RJE Console 
processing. The calling sequence is as follows: 

INIT REQUEST 

JSB .IOC. 

OCT PPWXX (XX is logical unit number) 

This request saves the EQT address of the unit for later 
reference. 

It may also be used to CLEAR operations active on the driver. 
An active operation will be reported by a .,BUFR call, creating a 
CRQ entry with M a M *3. 

The READ processor is entered to process READ reguests from 
an .IOC. call. The calling sequence is; 
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READ REQUEST 

JSB .IOC* 

OCT jnppXX (11PPXX for queuing) 

<reject address> 

DEF BUFR 

< buffer length> 

The <re ject address> is entered if the driver is busy. 
<buffer length> is the number of characters in the buffer. Only 
ASCII READ»s with byte data (positive buffer length) are valid. 
READ processor execution is summarized in the accompanying 
flowcharts. 

The WRITE- processor is entered to process .ICC. WRITE 
requests. The calling sequence is: 

WRITE REQUEST 

JSB .IOC. 

OCT 0200XX (12J30XX for queuinq) 

<reject address> 

DBF BUFR 

<buffer lencth> 

Aqain, only ASCII records with byte data are valid. The 
execution sequence is given in the accompanying flowcharts. 

The SP command processors process the 2 SP-to-IOP commands. 
These are: 

160011 Wake RJE up 

160026 Have console message 

160037 Console buffer empty 

Have console message results in an unsolicited event being 
placed on the CRQ. Its format is: 

A: j7prprpxx (where XX is console logical 

unit number) 
E: WWW 

A READ should be issued when such a request is received. 

A write command to D. 62 results in an IOP to SP command being 
sent (16LL05 where LL is length of message). Upon receipt of the 
"console buffer empty** coimand from the SP, the eessage is 
transmitted to the SP via DHA. 
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A read command is issued whan the SP indicates it has data 
for the RJE subsystem through a "have console message" command. 
Upon getting the read command from the RJE subsystem, an IOP to SP 
command is issued to tell the SP to send the data. That command 
is "wake RJE up" (160011). 
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£i2££2l§ iE PUt/Outpu t Handle r 
Desqpjlption and function 

The console input/output handler (CIO) is responsible for 
initiating all input and output requests to the console. It 
accepts console messages fxoi various handlers and issues queued 
write requests through .IOC. 

The handler responds to an attention request and issues a 
priority read to the console via queued .IOC. 

Another function of this handler is to identify the messages 
read from the console. This is necessary so that the message may 
be transferred to the appropriate handler. 



The handler must also recognize the responses to requests fo: 
the •System Connect 1 (SC coaaand) and 'System Disconnect 1 (SI 



>r 

-„- _„ ,-_ , _, ;sd 

command). It will then be possible to filter out inappropriate 
RJE commands before they are transferred to other handlers. 



The console input/output handler can receive console messages 
from several different handlers. The buffer is freed when the 
vrite request is complete with two exceptions. If the console 
message was received from the host message decompression handler, 
it is given to the ASCII files handler for the job message log. 
If it was received from ASCII files (jot inquire function) , it is 
given to HIO. 

The unsolicited event indication received by this handler 
will be a request to read from the console, an indication of 
system shut down, or an indication of system initialization. 

This handler will transfer messages to other handlers as 
follows: 

SC,SD,ER synchronous handler 
SR# r TR#,RR# host reader compression handler 
RC-nsg host inquire compression handler 

The DA command is handled within this routine as described below. 
Any other command is assumed to be an inquiry to the host and is 
sent to HIO. 

If the command from the console is to be transferred as a 
block of data to the synchronous handler (RC-msg), it is first 
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Bit (s) 


Word 


2 


3-0 


Word 


7 


15-0 


word 


8 


15-13 
12-0 


Data 


word 


1 15 

14 



converted from ASCII to EBCDIC via a call to th€ central 
conversion routine (.ATOE) • 

L°.£ll £l£& struct ij^es 

INBUP address of tuffer used for console input 

QNAME console input/output queue name 

SHNAM synchronous handler queue name 

CICNM host inquire compression queue name 

SYSGT 'system activity^ gate is set tc 'nop 1 if the RJE 

system is connected and set to •skip' it is not 

The buffer control wcrds associated with messages to be 
printed on the console are defined as follows: 

Function 

command=1 

message size 

Synchronous handler run status 

(unused) 

message is from HMO 

message is from ASCII files handler 

The buffer control words associated with messages transferred 
from the console to other hacdlers are defined as follows: 



Word 2. 

Word 7 

The unsolicited event indication is defined as follows: 

A-reg - 15 1 -system overflow flag 

0-normal unsolicited event 

14-12 zeroes 

B-reg - 15 system shut down 

system initialization 



Alcjoritha 

The console input/output handler has 3 entry points: 

CIOHI - initialization section 

CIOHP - scheduled primer section 
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Bit (s) 


Function- 


15-4 


(unused) 


3-0 


ccmmand=7 


15-0 


message size 



CIOHC - completed event section 

In the initialization routine, (CIOHI) , systea service .FIND 
is used to determine the queue names of all handlers with which 
communication is required. On entry , it saves the logical unit 
number and merges this number into all of its •IOC. call 
parameters. A clear .IOC. call is made to purge any previous 
outstanding reguestrs and to initialize the ICK driver. 

In the scheduled section (CIOHP) , all queue entries are 
inspected and appropriate .ICC. calls are made. If the entry is a 
buffer, a read request is queued and if it is a message to print, 
a write request is queued. £YSGT is opened or closed when the 
handler recognizes! a 'CCMKUNICATIONS ESTABLISHED" or 'SYSTEM 
DISCONNECTED 1 message, respectively. When communications are 
established, start commands are sent to ASCII files handler to 
start the job iressage and job inguiry functions. At disconnect 
time, stop messages are sent to terminate these functions. While 
RJE is active, console messages received from ASCII files will be 
sent to HIO and messages received frcm HMO will be sent to ASCII 
files handler. 

There are three main parts of the 10 complete section 
(CIOHI). When an unsolicited reguest for a read occurs, a buffer 
is obtained and a priority read request is made. When system shut 
down occurs, the queue is purged and all console messages are 
ignored until systea initialization is received. 

When an 10 complete indication is received, it is first 
necessary to determine if the completed event was a read or write. 
If a write, the buffer is then freed or passed en to HIO cr ASCII 
files as required. 

If the completed event was a read, the type of console 
message must be determined so that it may be transferred to the 
appropriate handler. If the RJE system is not connected, RJE 
coamands are inappropriate and an »RJE COMMAND NOT APPROPRIATE 1 
message is printed on the corscle. 

In the case of a • RJE-CA,hf<de v 1 or • RJE-DA,hf >dev« command, 
the text is scanned for syntactic errors. If correct, CIO uses 
the device assignment manager to make the assignment. If the 

assigauant is not sutrc^ssf vil , a.?, appropriate error rasssag* is 

priced. ' 

If the message is a 'ROE-DA* command, the DAT is scanned and 
messages are printed on the console reflecting current device 
assignments. 
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Sy nchro n ou s C ommuni cations Handler 

££scrij2tion and fn n otio n 

The synchronous commuricaticns handler (SH) manages all I/O 
en the communications line. . Once activated, it manipulates and 
controls the transmission and receipt of data within the defined 
IBM multileaving protocol* SH is activated at the request of the 
operator via the SC command. Activity than continues until an SD 
command or abortive communications line error occurs. SH will 
report data regarding line condition to the operator when directed 
to do so with ER. 

IBM's multileaving protcccl provides for the support of up to 
seven input streaus (card image) and , fourteen output streams 
(ssven print ana seven punch ra rd image) as well as a remote 
operator console input/output stream. These 23 streams are 
supported and managed by SH using 23 work queues. The number 
actually used deponds on the software and hardware configuration 
of which SH is a. part. At system initialization time, these 23 
work queues ar® enabled cr disabled as required by the 
configuration. O-ia other control work queue is also associated 
with SH for use in buffer acquisition, etc.- 

when a systen connection is made, the enabled work queues are 
attached to other function handlers which either produce data 
(input streams) or consume data - (output streams). SH. then 
interfaces with the host system via the multileaving protocol in 
order to control the flow cf data appearing on those queues. In 
appendix A of this base design document, is a specification of the 
multileaving protocol. Some terms which appear here (such as HCB 
and FCS) are fully defined in appendix A. 

Interfacing 

SH interfaces directly with the console I/O handler as 
follows: 

1. SH accepts the SO, SD, and E5 commands at any time. 
These must appear in console • buffers and en the SH 
control work queue. 

2. SH places messages on the console I/O work queue via 
*CCO. 

SH interfaces with an^ cne of its input modules as follows: 
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1. SH places a *SH running' message on the handler's work 
gueue. This message informs the handler of current SH 
parameters and indicates that the handler nay proceed. 
It is also used tc inform the handler that it may 
continue* (This latter point applies Yhen the handler 
suspends itself after having reached the queue limit 
prescribed by SH.) Contained in the message are: 

RCB - stream identification which the handler is to use 
in constructing its data blocks. 

Buffer size - current communications buffer size 

Queue name - name of SH input work gueue on which the 
handler is to place its data blocks 

Queue limit - maximum number of data blocks the handler 
should place on the gueue. At the limit, the handler 
should suspend itself (or at least refrain from further 
data handling) until a nev 'SH running' signal is 
received. 

node - a flag to indicate when the system is in ACCESS- 
to-ACCESS mode. 

2. SH accepts a start cemmand from the handler (except for 
the host inquire stream). SH then procedes to initiate 
the transmission of this stream to the host. The 
producing handler is expected to quiesce until this has 
occurred. SH vill issue a new 'SH running' cemmand to 
the handler once the transmission has been initiated. 

3. SH accepts data blocks from the handler on the 
specified work queue. A BCW definition for the final 
block in a series cf blocks must be adhered to. 

i». SH will purge tte handler's work queue if an abortive 

line error occurs cr when a normal disconnect occurs. 

The handler should view this as an 'SH not running* 
signal. 

SH interfaces with any cne of its output modules as follows: 

1. SH places a reguest to receive data signal on the 
handler's work queue. This signal will be contained in 
a cemmunications tuffer. When the handler has acquired 
all needed resources it is expected to return this 
buffer to SH in crder to signal permission for the 
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request. ACCESS-to-ACCESS mode will be indicated in 
this request to receive message, (This entire process 
does not apply to console output.) 

2. SH places data blocks on the handler's work queue. 
When the handler disposes of a block, it aust be* 
returned to SH tc signal a reduction in that handler's 
queue level. 

3. SH aay purge the handler's work queue if an abortive 
error occurs and will definitely purge when SB performs 
a signoff. This should be viewed as a signal to 
quiesce. In this case, blocks of data which are 
partially disposed of, should got be returned to SH. 

LSSSl £&£l structures 

These local data are us€d by SH: 

SNUB a switch used to indicate whether or net to .FREB 

the current SH work queue entry 

SWEAD holds address of current work entry 

SOL online/offline switch plus signon active/not 

active flags plus signoff activity flags plu3 
ACCBSS-to-ACCESS node flags plus auto restart 
flags 

STFCS current trarsirit FCS 

SRFCS current receive FCS 

SRSVB holds address of reserve receive buffer, when 

negative a buffer is pending 

SACQ used to deteraine if any input queues are active 

SSTBY holds address of buffer available after I/O 

coapletion 

SCTRL holds control queue naae 

SSIZE holds specified coamunication s buffer sise 

SIHBT holds nuaber of outstanding console aessages 

which aust be disposed of before continuing 
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SINQS 



SACQO 



holds number of input work queues actually 
available 

holds number of active output queues 



Definition of *SH runnicg* message which appears in a control 
buffer: 

BCW Word 2 

Word 3 

Word 7 

Word 8 

Data Word 1 

Note: this message is always placed on the recipients work queue 
using .PRIQ (priority .PU?Q)T 

Definition of blocks appearing on input work queues is as 
follows. Most of these defiriticns are internally generated! by 
SH: 



Eits 


15-4 


Zero 




3-0 


command=3 


Bits 


15 


(unused) 




14-0 


Queue name (SH 
input work queue) 


Bits 


15-0 


communications buffer size 
(negative 2 's complement 
number of words) 


Bits 


15-1 


(unused) 







- normal mode 

1 = ACCESS-to- ACCESS mode 


Bits 


15-8 


Stream RCB 




7-0 


Queue limit 



BCW Word 1 



Word 2 
word 7 



Word 8 



15 

14 
13 
12 

11 
Bits 3-0 
Bits 15-0 



15 



control transmissions 

(permissions/requests) 

signon transmission 

signoff transmission 

BCB and FCS are to be 

left alone 

BCB is to be left alone 

command=2 

length of the input data 

in positive bytes 

(see below) 

0=not end-file 

1=end-file 



Note: the position of the data in input blocks must be as shown 
below* The communications buffer size noted above in the 'SH 
running' message allows fcr this format and size. The maximum 
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size of the input data section of this format will be dictated by 
the operator's specification in the SC coamand. 

Data Word 1 **reserved** 

Word 2 **reserved** 

Word 3 beginning of input data 

• 

lord n end of input data (length of words 

3 through n is reflected in BCW word 7) 

The first 5 bytes (characters) of the input data are supplied by 
the synchronous handler but lust be included in the length. The 
last byte must contain an ETE character (octal 46) • 

Definition of aessages giv«?n to output handlers by SH, 
Message appears in a ccmauni cations buffer: 

BCW Word 2 



word 3 
Word 8 



Mote: these buffers are net interlocked. Response to the queue 
name in word 3 is cooperative not mandatory. The console output 
decompression handler will never receive a buffer with a ccaaand 
of 3. 

The responses to SH by output handlers must follow these 

definitions: 

BCW Word 2 Bits 3-0 comraand=3 

(permission to receive) 
coamand=5 

(data block finished) 
Word 8 15-8 RGB stream id 

7-0 (unused) 

When aessages are queued for the console I/O handler, these 
BCW definitions are made. Their purpose is to allow console I/O 
to note the running state of SH: 
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Bits 


3-0 


command=3 

(request to receive) 

comaand=1 

(data block) 


Bits 


15 


(unused) 




14-0 


Queue name for 
response 




15-8 


RCB stream id 




7-1. 


(unused) 







= normal aode 

1 » ACCESS-to-ACCESS mode 



BCw 



Word 2 
Word 7 
Word 8 



Bits 



3-0 

15-0 

15-14 



13-0 



comma nd=1 
message length 
00-normal message 
1 -co mmunicat ic ns 

established 
10-disconnecticn 
(unused) 



Tables are defined which contain appropriate data regarding 
each input and output stream. The tables allow for support of the 
maximum possible number of each type of data stream. However, the 
number of streams actually present is determined at system 
initialization time, with these not present being disabled. 



The Synchronous Trans nit Stream Table 
possible input stream: 



<STST) defines each 



STST entry 



- console input 

- card reader number 1 

- card reader number 2 



7 - card reader number 7 



STST entry format: 



worj 


Bils 





15-0 


1 


15-0 


2 


15 




14-2 




1 







3 


15 




14-0 


4 


15-8 




7-0 


5 


15 




14-0 



C onten ts 

Stream PCS definition 

Stream FCS state 

Permission to transmit requested 

(unused) 

• SH running* message needed 

Permission to transmit granted 

Stream presence or absence 

Queue name for producing handler 

Stream RCB 

Queue depth limit 

(unused) 

SH input gueue name 
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The Synchronous Receive Stream £able (SRST) defines each 
possible output stream: 

SRST entry - console output 

.1 - printer nuaber 1 

• 

7 - printer number 7 

8 - punch nuifcer 1 

• 

14- punch number 7 

SRST entry format: 

£°X3 Sli§ Contents 

15-0 Stream FCS definition 

1 15-0 Stream FCS state 

2 15 Permission to transmit requested 
14-1 (unused) 

Permission to transmit granted 

3 15 Stream presence or absence 

14-0 Queue name for consuming handler 

4 15-8 Stream RCE 

7-0 Queue depth limit (the maximum number 
of blocks vhich will be received prior 
tc suspending the stream via FCS) 

Al£cr,i.thj§ 

Two local data structures are of special significance. These 
are the Synchronous Transiit Streams Table (STST) and the 
Synchronous Receive Streams Table (SRST) . The eight entries in 
the STST define the possible input war* queues. Th€ fifteen 
entries in the SRST defice the possible output work queues. 
Contained in the tables are all parameters (flags, queue names, 
etc.) needed to use these queues .plus all parameters needed to 
control the producers and cocsumers of these queues. Entries in 
these tables are used sequentially in a priority fashion. For 
example, the STST is ordered as follows: console input, card 
stream 1, • •••, card streai 7. Thus, transmissions for card 
stream n will tend to take precedence over card streams greater 
than n. The console will always have greatest priority. This is, 
of course, subject to the aetering of data by the line protocol. 
SRST entries are used in a siailar manner. 

The systea initialization entry point to SH is SYNHI. The SH 
control queue name is found and saved in SCTRL. Finally, SYNHI 
"configures" SH by initializing the STST and SRST tables. This 
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involves attempting a .FIND fcr all possible work queues and 
associated producers and consumers. Those table entries for which 
the .FIND'S are successful are enabled. Remaining table entries 
are disabled. On a systea restart, if the auto-restart flag is 
on, a restart is attempted. 

The prime entry to SH is SYNHP. All work queues associated 
vith SH activate this same prite entry. SYNHP consists of three 
main sections. The first is the entry point section which removes 
work from the control queue and invokes processing of the work 
entries. Section two consists of a group of processing sections, 
each of which processes a control queue work entry. The third 
section is an I/O scheduler which is also used by the I/O complete 
entry point to SH. The I/O scheduler performs the task of 
examining the STST entries for transmission or ether I/O 
scheduling. 

SYNHP is entered by a system prime. It then invokes 
processing of each work entry found on the control wcrk queue. 
The routines which handle these work entries all return to a 
common point where the current work entry is released to its 
buffer pool if appropriate. Other work queue entries are 
processed in turn until none remain. At this point the I/O 
scheduler is entered for possible I/O initiation. 

These messages may appear on the SH control work queue: 

S C y SDj. or £R commands - the command is received from the 
console I/O handler and is processed by routine SBJEC. The 
work entry is in a console buffer. 

SJLE^X o utpu t feuffer - this is a communications block which 
was previously received, has been disposed of via cue of the 
output work queues, and is now being returned to SH by the 
associated consuming hardier. Its function for SH is to 
signal a reduction in the number of blocks on that output 
work queue. SH uses this technique to monitor the flow of 
data and use of communications buffers. SQCHK processes 
these entries. 

«EliHt££ alloga^pn signal - received from a consuming data 
handler tc indicate that all of its needed resources are 
available and that SH may commence receipt of data for the 
output stream. SPALL processes these entries. This work 
entry appears in a communications buffer. 
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Allocated coa aiunic at^ons buffer - received from the buffer 
manager in belated response to"a buffer request Bade by the 
I/O scheduler* SCOMB pzccesses this work entry. 

allocat ed con sole fcq.ffer - received from the buffer aanager 
in belated response to some previous request for a console 
buffer. SCONB processes the entry* 

allocated control b uffe r - received froa the buffer aanager 
in belated response to a previous request for a control 
buffer* SCTLB processes the entry* 

Work entry processing by 5YNHP is as follows: 

JLEALL " locates the . SBST for the associated output streaa. 
When" in ACCESS- to- ACC5SS n» ; d ■», the RGB received is 
temporarily changed frca an input type RCB to a printer type 
RGB in order to locate the SRST entry* A "peraission to 
transmit" control record for the streaa is constructed in the 
work entry buffer (a coimunications buffer). This buffer is 
placed at the beginning of the console input work queue 
(highest priority STST entry) for subsequent transmission. 
This is really just a trick to allow these high priority 
messages to be selected for transmission as soon as possible. 

sgc.HK - locates the SRST for the associated output streaa and 
determines the current *ork queue depth. When in ACCESS-to- 
ACCESS mode, the RGB received is temporarily changed froa an 
input type RGB to a printer type RGB in order to locate the 
proper entry in the SRST. If below the SRST defined" limit, 
the stream control bit in the send function control sequence 
(PCS used in aultileavirg protocol) is enabled. 

SCO p - if the system is not online, the buffer is released. 
Otherwise, its address is saved in SRSVB for use by the I/O 
scheduler. 

§£2Isl • i f tne system is not online, the buffer is released. 
Otherwise, it is supplied to SHBUN for the issuance of "SH 
running" messages to available producers of input work queue 
data. 

SCONB - the buffer is supplied to .CCO. for console output. 

SRJEC - for an ER coamand, the data is acquired and the 
messages are constructed and issued. 
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For an SC command: 

1. If SH is online or not online but engaged in going 
online, the 'SYSTEM ALREADY CONNECTED 1 message is 
issued. 

2. If SH is not cnline ajid is not going online, the SC 
data (buffer size and signcn record) are processed. 
Then the signon activity signals are set, the •SYSTEM 
READY* message is, issued, and the data line enable I/O 
operation is started. 

For an SD command: 

1. If a signoff is already in progress, the command is 
ignored. 

2. If SH is not online or engaged in a signon, the 'SYSTEM 
DISCONNECTED 1 message is issued. 

3. Otherwise, the signoff record is processed. Signoff 
conditions are established and the auto-restart flag is 
turned off to disable the restart feature. 

All I/O scheduling (except for the initial data link enable 
and terminal clear) is performed by SIO. SIO is entered by SYNHP 
when control work queue is exhausted. SIO is also used by SYNHC 
to initiate succesive I/O operations. If I/O is active when SIO 
is entered, it exits to the central system commutator. Otherwise 
it performs the following sequence of steps: 

1. If SH is no longer onlire, SPRGE is entered tc clean up 
all queues, etc. 

2. If the host has temporarily disabled transmissions to 
it (WABT or wait-a-bit) , processing continues at step 7 
in order to attempt a receive only operation. This 
will not occur when in ACCESS-to-ACCESS mode. 

3. A scan of all input work queues now occurs: 

A. The first input work queue (normally console 
input) may contain permission to transmit control 
records. If so, these are immediately selected 
for transmission. 
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B. A local variable, SACQ, is used in the remainder 
of the scar tc note the presence of active 
transmit streams. 

C. if a data block appears on an input work queue, 
then: 

a. If the stream's current PCS state is 
disabled (host has temporarily suspended 
this stream), then no further processing of 
this stream occurs. 

b. Other vise, SACQ is set to shov at least one 
active input vork queue. 

c. If permi iv: to initiate transmission has 
been received from the host, the data block 
is removed from the work queue* If the 
queue depth drops below the STST defined 
limit, an *SH running 9 command is re-issued 
to the associated handler so that it may 
continue. If "the block contains end-file, 
the S1ST transmit permission is cleared. 
(If SIO is currently active because of 

SYNHC and a secondary communications buffer 
is available, it is now released.) 
Transiission of the block is scheduled* 

d. If no permission to transmit exists but has 
been requested, no further processing 
occurs. otherwise; if a tuffer is 
available, the request is constructed and 
scheduled for transmission. 

4. This point is reached if no iABT exists and no input 
work queue transmissions can be scheduled. If SACQ 
shohs active input work queues, processing continues at 
step 7 to attempt a receive operation. 

5. If there are no active input queues, the output queues 
are checked. If sose are active, a receive operation 
is attempted as at step 7. 

6. If no work queues are active and. a . signoff is pending, 
the transmission cf the signoff record is scheduled. 
Otherwise, a receive operation is attempted. 



5-17 



7. Processing continues at this point if jjo transmit 
operations can be scheduled. If a buffer is available, 
a receive only operation is scheduled. Otherwise an 
exit occurs. 

8. I/O scheduling always involves application of the 
current SH transait FCS which informs the host about 
the desired receipt of data by SH. I/O is then begun, 
and I/O activity is flagged. Finally, an exit occurs. 

SIO utilizes a subroutine called SIOBF. This subroutine 
provides, if possible, the address of a communications buffer to 
its caller. The buffer may ccae from either of two sources. A 
standby buffer is one that S1NHC has determined is of no further 
use. This one, if available, is always given away first by SIOBF. 
Otherwise, if a primary buffer • is available, it will be supplied. 
If there is no primary buffer, an attempt is made to acquire one. 
If this fails, one will appear later as handled by SCOMB. 

SYNHC is the I/O complete entry pcint to SH. It processes as 
follows: 

1. I/O activity flags are cleared. If any abortive error 
has occured, SPRGE is entered to clean up. 

2. If the operation completing is a signoff transmission, 
a clear I/O operation is performed and SPRGE is 
invoked. 

3. If the operation is a successful connection following 
the SC command's data line enable, BCW8 is checked to 
determine the mode of operation. If in normal mode, or 
ACCESS-to-ACCESS/slave mode, the sign-on record 
transmission is begun. If in ACCESS-to-ACCESS/master 
mode, the handler waits to receive the sign-cn record 
from the slave system. 

J*. If the operation is signcn completion, SH is placed 

online and the » COMMUNICATIONS ESTABLISHED 1 message is 
issued. If a signoff has been requested, the signoff 
transmission section of SIO is invoked. Otherwise, th« 
'SH running' control signals are issued to all 
associated input handlers using SHRUN. 

5. If the operaticn is a completed transmit/receive 

sequence, the received FCS is processed. 
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6. The RGB in the received data is then examined. In 
ACGESS-to-ACCESS mode, an input type RGB is changed to 
a printer-type RCB in order to locate the proper entry 
in the SRST. They type of RCB determines the 
processing as follows: 

A. If a request to transmit, and a signoff is 
pending, the request is ignored. Otherwise, the 
associated cutput handler is activated. 

B. If a permission to transmit, the STST is Barked. 
In this case and in the case where step A leads 
to ignoring the reguest, the buffer is 
established as a secondary buffer fcr SIOBF. 
Then SIO is entered. 

C. If data, the block is enqueued to the proper 
output work queue. If that queue limit is 
reached, the associated FCS bit for the streaa is 
disabled. 

SHRON is a subroutine used to present signals to associated 
input handlers informing thea of SH activity and parameters. It 
searches for marked STST's requiring this signal, and transmits a 
message to the handler containing its intended RCB, input work 
queue name, queue limit, and current communications buffer size. 
SHSUN is invoked either by SYNHC following a signon or by SCTLB in 
belated response to the reqrest for control buffers. It can also 
be invoked by SIO when an incut work queue drops below its queue 
limit. 

SPRGE purges all input and output work queues and associated 
handler queues. It resets SH to initial conditions, and issues 
the •SYSTEJ! DISCONNECTED 1 nessage. Finally, it clears the purge 
indication froi all SH work gueues and closes the SH prime gate. 
If auto-restart is requested, a new sign on is attempted. 
Otherwise, processing is terminated. 
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Note: This document assumes knowledge of IBM's Binary 

Synchronous Communications procedure, and the HASP Multileaving 
conventions. For those persons unfamiliar with the Multileaving 
discipline , Appendix A of the HP2 000 ACCESS Base Design 
Specifications for the base level program describes the HASP 
Multileaving protocol, 

I. Product Identification 
Product abstr.a^t 

The D.50F Driver interfaces 2100 computers to telecommunications 
devices usinq the subset of IBM's Binary Synchronous 
Communications required by. HASP Multileaving. In addition to the 
standard facilities of Multileaving, an auto answer capability is 
included in the program. 

II. Design Overview 

Design assumptions 

The program requires the following for operation: time base 
qenerator driver p. 43), aid the 12618, interface boards for 
synchronous transmission. System must also have appropriate 
common carrier equipment. 

Additional software required by this program includes the HP2000 
ACCESS I/O processor microcode. 

USJlSIi s umm ary 

D.50F is an input/output driver designed to operate in the HP2000 
ACCESS I/O processor. It will perform the following functions:: 

1. "Clear" . - puts I/O board in "on-hook" conditicc. Resets 

status words. 

2. "Write" - Transmits a data blcck. *No error correction is 

done. No reception from remote is initiated. 
Used primarily to transmit a final block such as 
a signoff • 

3. "Write/read" - S^rds a block of data to the remote and 

then waits, for acceptance/ rejection frcm remote. 
If block is rejected, it will te resent. If 
accepted, a ry incoming data overlays the buffer. 



5-20 



4. "Answer" - Allows data line to be established by answering 

phone or ty operator manual dial. It then 
initiates signcn protocol with the remote.- 

5. "Extended status" - Establishes a table for collection of 

statistics on device performance during a 
session. 

Because the Multileaving protocol- raguires the EBCDIC cede, the 
driver supports only the EBCEIC transmission code. 

with one exception the driver always operates in a WJ4t- Before - 
*y^ansm|,t A c|£n t cw3.e dgeme nt mede. WABT allows the processor to 
indicate a "temporary not ready to receive" condition to the 
transmitting station, when in ACCESS-to-ACCESS mode, the driver 
will net respond with WAET when it receives WABT in a normal 
WHITE/READ operation. Instead the driver will respond with ACK0 
and continue the read operation. 

The driver also supports Transparent mode, which allows data linx 
control characters to be transmitted as data without taking on 
control meaning. 

J2fi§i£& a£££2£ch 

D.5J3F is modular in its internal architecture. Each module may be 
classified as a "function prccessor" (modules are responsible for 
executing a particular function; i.e., "read", "write") or as a 
"common module" {modules cr subroutines which aid function 
processors) . 



III. Design Structures 
H& 12L jMS^iSEll mo dul es 

NOTE #1: when a call is rejected, the following return 

codes will appear in the "A" and "B" registers: 

izS.55ISTE R B-R5GJSTEE Reason for reject 

1 C Illegal reguest 

1 1 Local terminal is 

"off-line" 
1 100C00 Driver busy 
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Clear Re guest 

De.scsi.gt ion an.d functio n 

Puts I/O board in "on hook" condition (drops line). Clears status 
words except "extended status". 

Interface description 

The following calling sequence should be used: 

JSB .IOC. 

OCT XX where XX is logical unit number. 

This call is never rejected. 

Algorithm description 

1. Turn off I/O toards (drcp telephone line) • 

2. Clear status word in EQ1 entry. 

3. Return. 

Program min g hints: 

Do not use the clear function with the intent of merely clearing 
the "present operation" since it will drop the communications 
line. 

J!im2 Reguest 

This reguest is not directly available. It is a part of 

HRITE/READ processing. Read a block of data from the remote 

terminal. Execute error detection and correction on the new data 
block. 

The following error detecticn/correction procedures are used by 
the program: . 

1. The driver will re-read blocks of data received in incorrect 
parity up to 25 times. If still in error, a "DLE EOT" 
seguence will be sent tc the remote and the line dropped. 
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2. If more than 3 seconds pass without receipt of a ••SYN" 
character from the remote, the driver will consider the block 
in error and utilize the error processing in (1), 

3. If a "NAK" is the first control character received, the 
driver will resend its acknowledgement sequence. 

The following optional operational mode may be used: 

1. The driver will automatically detect transparent text, delete 
"DLE" characters, and exauine the characters following "DLE M 
for control characters. 

Interface specification 

The calling sequence for this reguest is discussed under 
W8XTE/HEAD below. 

The transmission leg will reflect: 

a) Characters received. 

b) Include SIX, SOH, and Ell characters. 
11325J&LB £S£Cll£tion 

1. Process write request. (See below.) 

2. Heceive data block from remote. 

3. Check parity on received block, requesting retransmission if 
the block was received in error. 

u. Check for iABT recaived. If so, respond with ACKp and 
continue the read operation. Else enable "WABT M time delay 
generation and terminate the read. 

Write/Bead Reguest 

2^1£li£ii2S. §Jk& functi on 

Sends a block of data to the remota then waits for an acceptance 
or rejection of the block. A data block may be read as an 
acknowledgement, as well as an ACK0. If the block is rejected by 
a NAK, it will be retransmitted. 
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The following error detection/correction facilities are 

in pie men ted: 

1. If remote fails to respond within three seconds after the 
block has been sent, a "NAK" is transmitted to request 
retransmisssidn of the response, 

2. If the remote's reply is invalid, a "NAK" is sent and the 
driver set to receive a new reply. This procedure will be 
repeated up to 25 times, whereupon a "DLE EOT" will be sent 
and the line dropped, 

3. If the remote "NAK"s the block 25 times, a "DLE EOT" sequence 
will be sent and the lire dropped. 

U. " If DATA SET READY signal status from the local modem drops, 
the I/O board will be turned off and the driver freed. 

5. A reply of "DLE EOT" will cause the I/O board to be turned 
off, and operation ended. 

The following optional operations may te raguested: 

1. Transparent mode allows all data, including the normally 

restricted data-link " line-ccntrcl characters to be 

transmitted as data. Transparent mode is indicated by a "DLE 
STX" at the beginning of the block. 

IlUSJElASS desc.ri£tion 

The following calling sequence should be used: 

JSB .IOC. 

OCT 22J9XX where XX is the logical unit number 

Reject Address 

Start Address of Buffer 

Length of buffer to b= sent 

WORD #1: Length of receive buffer. 

WORD #1 : Start cf receive buffer. 

WORD #3: Start of data to transmit. 

The call may be rejected for the following reasons: 
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1. Local terminal w off-lin€ M . 

2. Dri?ec busy. 

The following considerations apply when using a WRITE Request: 

1. Oser program must place the following data-link control 
characters in the block tc be sent: 

a) Place SOH # STX or DLE # STX at beginning of data. 

b) Place ETB at end cf buffer. 

2. A WRITE only operation can be. specified by a request code of 
2#p r XX« This call should be used only for the final write of 
a session and should be followed by a CLEAR request. 

AlESii^kl description 

1. Send data block to the remote. 

2. Send block check characters. 

3. Wait for remote to reply. 

4. Take appropriate action for remote^ reply. 

ACKp, DATA BLOCK Enable wait-before-transait 

generator and end operation 

NAK Resend the block. 

WABT Reply with ACKp and continue th< 

read operation. 

Answer Reauesjt 

Description and function 

Establishes line for l3cal terminal. Allows either manual 
connection or auto answer cornection* 

Tha following error detect icn/correction facilities are utilized: 
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1. If remote fails to respond to the "SOH, ENQ" within three 
seconds, another "SOH, ENC W will be sent. The process will 
be repeated up to 25 tiroes, after which a "DLE EC!" will be 
sent and the line dropped* 

2. If the remote replies with anything other than "ACKp", 
processing will continue as if a timeout had occurred in (1) 
above. 

l£i££Jl£^ descri.pt j-on 

The following calling sequence should be used: 

JSB .IOC. 

OCT 3JZFJJXX where XX is the logical unit number 

Reject Address 

The call may be rejected for the following reasons: 

1. Local terminal already "cn-line". 

2. Driver busy. 
HHP-lithm iS.S£Il£iion 

1. Prime I/O board to send. 

2. wait for carrier frcm racdem. ' 

3. Send "SOH, ENQ" to remote. 

4. Wait for response from remote. 

5. If response is ACK0, then we are in normal mode. Proceed to 
number 9. 

6. If response is SOH/ENQ, then we are in ACCESS-to-ACCESS mode 
and will take on the role of slave. Proceed to number 8. 

7. If response is ACK1, th€n we are in ACCESS-to-ACCESS mode and 
will take on the- role of master. 

8. Indicate ACCESS-to-ACCESS mode and master/slave role in EOT 
status word complete, the answer request. 

9. Activate "Wait-before-transmit" generator. 
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Ex teni ed Status Request 

Descrip^4 on , &Hi3 functi on 

The usage of this call is to pass statistics on the device^ 
performance during a session. 

IHiSXf ace description 

The following calling sequence is used: 

JSB . ICC. 

OCT 120XX where- XX is the logical unit number 

Reject Address 

DEF Buffer 

DEC 7 

Euffer BSS 7 

After this call statistics on device performance will be 
maintained in the buffer specified by the requestor. The call 
should be made before beginning a session. The call will never be 
rejected and will always yield an immediate completion return. 

£l£ori£hj description 

1. The following statistics are maintained in the requestors 
buffer: 

WORD 1 Number of buffer overruns. 

WORD 2 Number of timeouts. 

WORD 3 Number of M NAK"s received. 

WORD 4 Number of • data checks on incoming 

data. 

WORD 5 Number of unrecognized responses. 

WORD 6 Carrier losses. 

WORD 7 Error code - contains reason that the 

line was dropped. 

Value Reason 
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Dropped due to CLEAR 

request* 

1 Message sent/received 

25 times with line 
errors each tise. 

2 Modem dropped ready,, 

3 Received M DLE ECT M 

from remote. 

U (Not used.) 

5 Power failure 



St atus Request 



Description and fun cti on 

This request is used to pass to the user WORD #2 (device status) 
and HORD #3 (transmission leg) of the device »s entry in the 
equipment table* 

ISiSXJESSS d esc ription 

The calling sequence for this function is as follows: 

JSB *IOC* 

OCT 400XX where XX is logical unit number* 

Upon return the A and B register will contain status information 
as outlined below: 

A - register contains status. 

B - register contains transmission log. 

Status Eits : 

Bit Set Reset 

14 Line dropped due No error 

to abortive error 
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Powgr recovery pro ce ssing 

The P. 50 power recovery appendage is called from the D.04 
EBOdule. It first restores tie interrupt section states (1.50 and 
J. 50) using D.04? if necessary. Finally, the occurance of a power 
failure is narked for possible use by DIE as a disconnect type. 

The above processing is inadequate if interrupt routines are 
not active. This is because the driver may be involved in a 
receive or transmit operation and power loss to the lodea will 
cause these operations to fail to complete. However, this problea 
is overcome in the receive state by the receive timeout which is a 
standard part of all receive operations. The timeout will 
discover loss of data set ready and will lead to a disconnect. 

For the transmit state, a 15 second "watchdog timer" is 
employed to mcnitor all ti?tn .-;nd!,sion attempts. This timeout 
should never occur unless a power failure (or other modem 
catastrophe) keeps a transmission from completing. The timeout 
forces an interrupt leading to a disconnect. 

£tl£2£ Ia£o£aaJion 

The transmission log reflects the number of characters 
received in a write/read operation. On answer completion, the 
status word is defined as follows: 

bits 14 =0 no error 
=1 error 
1 «0 slave role in ACCESS/ACCESS mode 

=1 master role in ACCESS/ACCESS mode 
=0 normal mode 

=1 ACCESS/ACCESS mode 
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Hosl Li§t D ecompressio n Handler 
Description and function 



The host list decompression handler (HLO) has as its main 
responsibility the transformation of compressed data blocks from 
the synchronous handler to print or punch lines which are passed 
to the appropriate level 3 handler* It is also responsible for 
performance of the following control functions: Accept printer or 
punch allocation requests and perform the desired allocation, 
printing the RJE A WAITING PRINTEBn or RJE A WAITING PUNCH* ■ ess; ages 
if necessary. Accept disconnect requests and force printer or 
punch disconnection. Accept printer or punch error notices and 
produce ATTENTION REQUIRED messages. Accept device end-of-file 
notices and release the device. This handler does not have an I/O 
Complete section, since it dees not issue IOC calls. The module 
is coded in a "serially reusable* 1 fashion, with all locally used 
data accessed from a unique storage block. Thus, additional 
printer or punch streams may be added by replicating this storage 
block. 

HLO interfaces with the level 3 handler as follows: 

1. A start command is placed on the level 3 handler's work 
queue to activate it. It contains the stream RCB, the 
communications buffer size, the name of the queue to 
receive the response, and a flag to indicate normal or 
ACCESS-tO-ACCESS icde. 

2. Allocated print or punch buffers and emptied print or 
punch buffers are accepted from the level 3 handler. 
These are filled with decern pressed data and given to 
the level 3 handler. At termination they are freed by 
HLO. 

3. Error message buffers from the level 3 handler are used 
to report error conditions to the operator. 

4. A stop command is sent to the level 3 handler at end* 
of-file or synchrcnous handler disconnect. 

5. A 'start timed retries 1 command is sent to the level 3 
handler when HLO is notified that the printer or punch 
is not ready. 
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HLO interfaces with the synchronous handler by accepting 
blocks of compressed data for the printer or punch. 

No BCW definitions are made by this handler. It conforms to 
those defined by the synchronous handler and printer handler. 

Al^orl&m 

A significant feature of the inputs to the routine is that 
they include a mixture of notial messages entered by . POTC calls 
(print blocks, allocate requests, purge queue request) and 
priority messages entered by . PRIQ calls (printer error, printer 
EOF, and buffer messages). As a result, upon entry to the handler 
the queue must be inspected to detect priority calls. Hence, a 
.SEEQ call is used to create a latch to different message 
processors. These message processors are discussed below. 9hen a 
processor has finished it will execute a .GETQ to remove its entry 
and return to the .SEEQ latch or .CON.; depending on the type of 
processing performed. 

"DISCO is entered for purge-queue reguests # which cnly result 
from a communications disconnect. If a device is allocated, the 
routine deallocates the device, issues a purge command to the 
level 3 handler, releases any unused buffers, and resets local 
storage. 

ALLOC is entered for printer or punch allocation requests. 
If the device is already allocated to this handler, the allocation 
request is delayed. otherwise the routine attempts to allocate 
the device, sends an ^AWAITING PRINTER* or "AIAITING PUNCH" 
message to the console, if necessary, and sets a timer loop to 
retry allocation. A pathological case of special interest is when 
a buffer cannot be obtained for the console message. In this case 
tha entry latch for the routine is reset to allow no further 
actions until the buffer is received as a message. This technique 
is used elsewhere in the handler, but is not further elaborated in 
this document. 

PRBLK is entered for print or punch block queue entries. A 
buffer is obtained from the free list and entry is made to .DCOM 
to decompress lines for output. The routine also sets carriage 
control, if necessary, and then ships lines to the level 3 
handler. It is also responsible for indicating print or punch 
block processed to the Synchronous Handler when finished. Again, 
suspension may occur due to unavailability of a buffer, and the 
latch-restart technique is used to continue processing. 
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PRFLT is entered for printer or punch faults* PRERR is 
intered when the printer is not ready. PRERR issues an "ATTENTION 
REQUIRED" message to the console and is done. Again, a latch- 
restart for buffer not available suspension is used. 

PREOP is entered when the step command is returned by the 
level 3 handler. All print cr punch buffers are freed by HLO and 
the device is deallocated. 

PRBUF is entered for tuffer messages. It stores the buffer 
message to allow proper operation of the latch-restart routines 
and then goes to .SEEQ to allow continuation of the suspended 
operation. 

The only other entry to this handler is the initialization 
entry. This simply calls .FIND to find its own queue name for 
future reference. 

£uj>£2dule. igsgriptjons 

PDCC is the functional module in the handler which receives 
control after a printer buffer is obtained and determines the 
carriage control character to insert in the buffer. Print-then- 
space mode is always utilized by this handler, so control is 
always executed before printing^ In ACCESS -to-ACCESS mode, the 
value in the SRCB fPCF control code} is moved intact to the high- 
order byte of the first data word. In normal mode, PDCC maintains 
the following data to determine the spacing and convert 
multileaving control characters to PCF control codes: 

STATE State indicator 

- Last control was immediate (I) 

1 - Last control was after print (A) 

CH Contrcl hold 

Stores last control for control after 
print operations. 

Input SRCB's may be considered as ordered pairs of data: 

(H,C) , where If is when the ccntrol function is to be performed, I 

immediate, A - after print, and C is the control operation. le 

may now define the operation of PDCC in terms of possible 

(STATE, («,C) ) combinations. 

STATE f w.C) O peratio ns 

0-1 (I*C) Carriage ccntrol <- C 

Decompress data and queue 
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0-1 (A,C) Carriage control <- space 

CH <- C; STATE <- A 
Decompress data and queue 

1-A (A,C) carriage control <- CH 

CH <- C; 

Decompress data and queue 

1-A (I#C) Carriage control <- CH 

STATE <- I 

Data <- one blank; Queue data 
Adjust pointers to reprocess 
this block 
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!■?£.%. read er c ompress ion handler 

Des criptio n and , func tion 

This haadler (HRO) allocates and manages a card reader 
handler in order t.i pre-process the card data for the synchronous 
•communications headier. Pie-processing involves compressing and 
blocking card iua<j£3 < into the acceptable communications format* 
The code for this handler will be written as a separate "serially 
reusable" module. The actual handler will consist of a block of 
storage .for the local data structure and appropriate calling 
sequences to the c^de. HRO is a level 2 function handler, and its 
interfacing to a card reader handler follows the level 2 - level 3 
protocol. 

Interfacing 

HRO utilizes \ts allocated reader as follows: 

1. A start buffer is placed on the reader's work queue to 
initially activate it or to reactivate it. The form of 
this bviffer is as prescribed by the level 2 - level 3 
protocol. 

2. Allocated reader buffers are accepted from the card 
reader handler* They are set to a read command and 
returned. These same buffers return as writes to HHO 
with useable data. They are always given back to the 
allocated reader as reads except when terminating, in 
which case they are freed. 

3. Error commands from the allocated reader are used to 
report the error to the operator. 

4. HRO sends a stof command to the allocated reader when 
HRO is deactivating due to a TR command or synchronous 
handler disconnect. 

HRO interfaces with the synchronous handler by: 

1* Placing compressed blocks 'of card images on the work 

queue indicated in the •SH running' message. If the 
limit of this gueue is reached, HRO suspends until 
reactivated with a new 'SH running' message. 

2. End-of-file signals from the reader are indicated to 

the synchronous handler as prescribed by its base 
design. 
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kSSll data structures 



The following symbolic names are associated with the local 
data structure used by HBO* In fact, these names are used as 
indirect pointers to the local data and do not contain the data. 



CCCPG 
CCQNH 
CCFLG 



CCRDH 
CCSHQ 

CCCCB 
CCCBP 
CCCBE 
CCCBS 
CCBCB 



holds the address of the prime gate for the 
active function handler 

hold the wcrJc queue name for the active function 
handler 

contains several flags: 

CCSHR synchronous handler status (♦■running, 
0=not a«-~ ... -, --running but CRC is at queue 
limit) 

CCPCR set = ck to process card data 

CROTA set * all compression resources available 
(communications buffer and not at queue 
limit) 

CCEOF set = at end-of-file with not ready reader 

CCTHC set - TB command is pending 

CCWST set = Waiting for level 3 handler to stop 

CCSPN set = start reader is pending 

CCATA set * ACCESS-TO-ACCESS mode 

holds queue name of allocated reader 

holds queue name tc which compressed data is 
delivered 

holds address of communications buffer 

current position within communications buffer 

address of end cf ccmounications buffer 

holds siza cf communications buffer 

holds streaa BCB for input to CCSHQ 
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CCSRC 
CCQLH 
CCRET 



holds carriage 
to- ACCESS mcde. 



control for SRCB when in ACCESS- 



holds qusue Unit for maximum number cf buffers 
to place on CCSHQ 

holds return address for delayed returns fron 
subroutine CGCB 



No buffer definitions are forced by HRO* It ccnforas to, 
those required by the synchronous handler and the level 2 - level 
3 protocol. 

when this nodule is entered, register A is loaded with the 
address of the block of local storage for the specific compression 
function handler vhich is being primed or initialized* A routine 
named CADDS generates a series of indirect address pointers for 
the local storage in question* 

HROHI is the system initialization entry point tc HBO* The 
only function performed is tc .FIND the HRO work queue name* This 
name is stored in CCQNM* 



HROHP is the prime entry 
processed include: 



to HRO* Work queue entries 



JJJ run nine} - a signal f 
running* This message 
informs HRO that it may 
also informs HRO that i 
queue limitations*) H 
message is received* I 
operate: the stream RC 
name of the queue to re 
for this queue, and 
ACCESS-to-ACCESS mode, 
processing as an inh 
processing* 



iom the synchronou 
is received in a 

initiate process! 
t may continue if 
BO will not do 
n the message are 
E, the communicati 
ceive data from HR 
a flag to indicate 

HBO is designed t 
erent part of the 



s handler that it is 

control buffer and 

ng at any time* (It 

suspended due to 

any work until this 
parameters needed to 
ons buffer size, the 
0, the queue limit 

if the system is in 
o include SB command 
•SH running' message 



£JL ILa. £H3 $& com mands - these messages are received from 
the console I/O handler as operator requests to activate and 
control use of a reader* These messages are not valid unless 
preceded by an *SH running' message. 
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Reader data - card iiages fron the reader allocated by CRC 
are blocked and compressed. Error indications from the 
reader are also processed* 

purged queue - the HBO work queue can be purged by the 
synchronous handler due to abortive errors or noraal 
termination procedures. In any case, HRO deactivates its 
allocated reader, deallocates sane, and guiesces until the 
next f SH running 1 message is received. A stop command sent 
to the reader as a part of purge processing will also return 
to HRO later. 

Control r conso^e^ a nd c ommunication s buffers - these may be 
received from the buffer manager in belated response to 
requests for buffers. 

££J&£2l operations - wht:n in normal mode, a control 
represents end-of-file and all other controls are ignored. 
When in ACCESS-to- ACCESS mode, control represents end-of- 
file and all other controls are for carriage control* * The 
value is saved at CCSRC and is passed along in the SRCB for 
the next data to be compressed. 

Allocation and manage sent of the card reader handler is 
affected by three sources: activity signals from the synchronous 
handler, operator directives and device status signals from the 
card reader handler itself. The synchronous handler informs HRO 
(as well as other modules) that it is functioning by placing an 
•SH running 1 work entry on the HRO work queue. Only when this 
signal has been processed can other signals be effective. 
Similarly, a purged HRO work queue (purging done by the 
synchronous handler) indicates that the synchronous handler is 
ceasing to function. 

Between the "running" and "purged" signals, operator 
directives (£tart Reader, Restart Reader, and £erainate Reader) 
are accepted. Mote that the synchronous handler connection signal 
internally causes an SR command to be processed. A purge signal 
also implies a TR command. The SR command causes an allocation of 
a card reader handler to be attempted. A message indicating the 
result is issued in either case. If successful, initial 
conditions are established and a start buffer is acquired. This 
buffer is put on the card reader handler work queue with EBCDIC 
reading mode and the HRO name indicated. This will activate the 
card reader handler as described in its base design. An BR 
command is routed to the allocated reader for actual .handling. 
The TR command inspects an HRO activity indicator and either 
deallocates the associated handler immediately if no cards are 
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being processed or flags the TB condition to be effected at end- 
of-file. 

Once allocated and started, the received card images are 
compressed by the central concession nodule and pot on the 
associated synchronous handler work queue. Tvo problems can 
interrupt this compression flew. When a communications buffer is 
not available, an indicator of this condition is set. If a card 
image appears on the HRO work queue prior to the needed 
communications buffer, that card image is replaced on the HBO 
guaue (via . PBIQ) and the HBO handler exits after closing its 
prime gate. This prevents further processing of card images until 
the needed communications buffer becomes available. Any errors 
indicated by the card reader handler to HRO will result in the 
issuing of an error message. An end-of-file signal is propogated 
through the central compression routine to the synchronous 
handler. Following the processing of an end-of-file, the TB flag 
is inspected and appropriate action is taken. Read buffers are 
always returned to the allocated reader immediately following 
processing of the data ic them. This technique insures that a 
read operation is continually being attempted and is the way in 
which the M hot reader" feature is implemented. 
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112J& Me s sage Decompression Han dl er 
De scri ption an d fu nctio n 

The function of the host nessage decompression handler (HMO) 
is to receive blocks of coapressed data from the synchronous 
handler, decompress the data, and transfer it to the console 
input/output handler. 

£&te£la£i&<l 

This handler communicates with the synchronous handler and 
the console input/output handler. Its input queue entries are 
either blocks of compressed data from the synchronous handler or 
console output buffers reguested by the handler itself. 

Input buffers received from the synchronous handler are 
returned vhen the entire block has been decompressed. This vill 
serve as a signal to the sycchrcnous handler that this handler is 
able to accept more work. 



IiSSal £Us3 st£U<;tures 

the input data block, 
the output buffer. 

t the next data block to be 
d. NDATA will be zero vhen there is 
cck being processed. 

he sise (number of bytes) of a 
d message. 

n unconditional skip - set to •nop 1 if 
sed message must be folded into a 
cle buffer. 

nconditional skip - set tc •nop # if 
is suspended because it cannot obtain 

tput decompression handler queue name, 
ut/output handler gueue name. 

Buffer control words associated with input queue entries are 
as defined by the synchronous handler. 

Buffer control words associated with output queue entries are 
a:s defined by- the synchronous handler (exhausted input buEfers) 
and by the console I/O handler (output messages). 



INBUF 


address of 


OUTBP 


address of 


NDATA 


address o 




decompresse 




no input bl 


SIZE 


retains t 




decompresse 


KDDC1 


normally a 




a decompres 




second cons 


KDOBP 


normally u 




the handler 




a buffer. 


QNAME 


console ou 


CIONM 


console inp 
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Algorithm 

This handler has two entry points: an initialization section 
(HMOHI) and a main queue entry processing section (HMOHP). At 
initialization, the gueue names of this handler and the console 
input/output handler are fourd via •FIND and saved. 

The host message decompression handler receives blocks of 
compressed console messages frcm the synchronous handler* One 
block may contain several console messages. It is therefore 
necessary to determine whether or not a block of data is already 
being processed. If so, the output buffer processing section of 
the handler is entered. If cot the input queue t processing section 
is entered. 

In the input gueue iandling section, a gueue entry is 
obtained. It will be either an input block or a buffer. If it is 
a buffer, the decompress routine is entered. If it is an input 
block, and the handler is waiting for a buffer, the entry is put 
back on the top of the gueue. Otherwise the output buffer 
processing section is entered. 

In the output buffer processing routine, a check is made to 
determine if a buffer has already been reguested. If so, the 
input gueue handling section is entered. If not, a console buffer 
is reguested. If the request is satisfied, the decompression 
section is entered. If not, the handler suspends itself until a 
buffer is acguired. 

In the decompressior section, one line of data is 
decompressed into an intermediate buffer using .DCOH. Depending 
on the size of the decompressed message, either one or two console 
buffers receive the text and are sent to the console I/C handler. 
If the input block is completed, it is returned to the synchronous 
handler. If net, no further processing takes place and the 
handler simply exits. 
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K cst Incruirg Co mpress ion H andle r 

Des cr iptio n and fu nctio n 

The primary function of the host inquire compression handler 
(HIO) is to receive remote- command messages ' from the console 
input/output handler, compress them, and transfer them to the 
synchronous handler* 

Int erfacing 

The host inquire compression handler will communicate vith 
the console input/output handler and the synchronous handler* 

Queue entries received from the console input/output handler 
will be ROmsg type commands* Th«* no??sage may or may not have 
•RC, 1 in front of it* This handler will compress the messages and 
give them to the synchronous handler* 

The only queue entry received from the synchronous handler is 
a control buffer indicating a • SH running 1 command* The buffer 
will contain the synchronous handler queue name, queue limit, 
communications buffer size, and the RGB for the console* 

Buffers received as input will be communications buffers 
requested by this handler* 

local da£a stru ctur e s 

One constant is established at initialization time and is 
never modified* 

QNAME console input compression queue name* 

Two constants are used in the calling sequence of the 
centralized compression routine. 

INBOF address of the input buffer* 

OOTBF address of the output buffer*. 

Three constants are used only by the console input 

compression handler* 

BFLMT established when an output buffer is obtained and 
is used to determine whether or not another entry 
will fit into the output buffer* 
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QSIZE established when an input queue entry is 
obtained, if there are no more entries on the 
queue, the cutput buffer will . be immediately 
transferred to the synchronous handler. 

5FLAG normally zero. It is set to -1 if the handler is 
suspended because the SH gueue limit has been 
reached. 

Four constants are passed tc the handler by the synchronous 
handler with the 'SH running' command. 

QLIH the maximui number of entries that may be in the 
synchronous handler's input queue. 

SHNAM synchronous handler gueue naae. fihen this value 
is zero, the handler is not operational and will 
discard any input queue entries. 

CBSIZ communications buffer size. This value is 
required in the request for a communications 
buffer. 

CRCB RCB for the console 



The console input compression handler has two entry points. 
In the initialization section, HIOHI, the handler's own gueue name 
is found via .FIND and saved. 

The operation of this handler is controlled by the 
synchronous handler. It will not receive any input gueue entries 
until communications have been established and it has received a 
•SH running' command from the synchronous handler. If 
communications are broken, the input queue will be purged by the 
synchronous handler and all gueue entries will be discarded until 
the next 'SH running' command is received. If the synchronous 
handler input gueue limit is reached, the host inquiry compression 
handler will suspend itself. Any queue entries received while the 
handler is suspended will be put back at the top of. the queue. 
Tha handler will not process any entries until the next 'SH 
running' command is received. 

The HIO handler will process as many queue entries as 
possible at one time, when there are no more queue entries, it 
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will complete tha output buffer and transfer it to the synchronous 
handler even if it contains only one console message. 
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Appendix A 

Multileaving Specifications 

Descrip tio n 

' "Multileaving" is a tern which describes a ccmputer-to- 
coraputer commurication protocol originally developed by IBM for 
use with its HASP systea. IBM's ASP, VS1-JES, VS2-JES2, and VS2- 
JES3 now also support the lultileaving protocol. In a gross 
sense, multileaving can b€ defined as the fully synchronized, 
pseudo-simultaneous, bi-directional transmission of a variable 
number of data streams betweeen two cr more computers utilizing 
binary synchronous communications facilities. It must be 
emphasized that this is not a full duplex protocol, although full 
duplex equipment may be used. Binary synchronous communications 
implies bi-directional transmissions, but in only one direction at 
a time. This protocol is as viable on half duplex communications 
links as it is on full duplex. 

■3Ai2£ compo nen ts 

At the heart of the protocol is a technique commonly referred 
to as "conversational acknowledgement." Many communications 
protocols provide for acknowledging the correct receipt of data 
with special control sequences (ACK or ACKO and ACK1). These 
protocols have the disadvantage of wasted time in the sense that 
the communications line must be "turned around" to transmit the 
acknowledgement. The acknowledgement is then transmitted, and the 
line is "turned around" a second time for more data transmission. 
Multileaving acknowledges the correct receipt of data with data. 
Thus, the protocol is conversational — transmit data, receive data, 
transmit data, receive data, etc. Only when an error occurs which 
requires retransmission, or fchen one cf the two parties has no 
data to transmit, does this flow break. In these cases, error 
correction or hand-shaking procedures are initiated. It should be 
cbvious that this conversational technique has a potential for 
greater communications line utilization. It also gives the 
participating computers greater potential since processing of 
received data may be overlapped with the transmission of data. 

Another aspect of the multileaving protocol is its support of 

:\ variable number of independent data streams in each direction. 
Sach bio.;* of dat* transmitted from computer A to computer B nay 
contain one or mors individual messages or records. Each message 
is tagged with its unique data stream identifier sc that the 
receiver (computer B) can sort the messages out and route them to 
appropriate destinations. An additional feature of the protocol 
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allows the receiver of messages (computer B) to control its 
initial and continued receipt of the messages for each data 
stream. This is done as a part of the conversational 
transmissions back to the sender of the messages (computer A). It 
should be remembered that this protocol is bi-directional. 
Therefore, each computer may play both the roles of sender and 
receiver. So the statements just made about data streams in the A 
to B direction are also simultaneously true about those data 
streams in the B to A direction. It must now be apparent that the 
data making up each transmission typically contains at least three 
things: the inherent acknowledgement of any previously received 
data, one or more messages, and control information regarding data 
streams which may be returned. 

A third important aspect of the multileaving protocol is its 
use of data compression. Each <>* the messages included in a 
transmission is compressed in order to remove character redundancy 
via encoding. This, of course, can alsc improve line utilization 
by reducing the actual number of characters in the transmissions. 

IraHJjlss^on £&Uo.sophy 

The basic element of each multileaved transmission is the 
character string, one or more character strings are formed from 
each message input to the computer for transmission. Messages are 
usually of the classical types (card images, printed lines, 
magnetic tape records, etc.). For efficiency in transmission, 
each message is reduced to a series of character strings of two 
types. These are (1) a variable length nonidentical series of 
characters, and (2) a variable number of identical characters. 
Due to the high frequency cf blank characters, a special case is 
made in (2) above when the duplicate character is blank. An eight 
bit control field, termed a String Control Byte (SCB) . precedes 
each character string to identify its type and length. Thus a 
string as in (1) is represented by an SCB followed by the 
nonduplicate characters. I string as in (2) above can be 
represented by an SCB and a single character (the SCB indicates 
the duplication count and the character following is the character 
to be duplicated). In the case of an all blank string, only an 
SCB is required to indicate toth the type and the number of blank 
characters. A message to be transmitted is therefore a group of 
character strings, each preceded by its respective SCB. A special 
trailing null (zero) SCB delinits the message. 

In order for the receiver cf messages to be able to associate 
each message with a given data stream, an additional eight bit 
control field precedes the group of character strings representing 
the original message. This field, the Record Control, B y _$e (RCBy , 
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indicates the general type, function, and unique identification of 
each data stream. Note that the RCB also provides for the 
grouping of multiple messages of various types into a single 
transmission block, A null (zero) HCB delimits the block. A 
second eight bit control field, the Sub -Record - Co ntrol Byte (SRCB ) 
is also included immediately following~the RCB. This field may 
provide additional information concerning the message to the 
receiving program. For example, in the transmission of messages 
to be printed, the SRCB can be used for carriage control 
information. 

For actual multileavinc transmissions, a variable number of 
messages may be combined into a variable sized block (i.e. RCB, 
SRCB, SCB1, SCB2, ..., SCBN, RCB, SRCB, SCB1, ... etc.). The 
protocol allots for the conversational exchange of such 
transmission blocks. To allow optimum use of this capability, 
however, the participating computers must have the ability to 
control the flow of particular data streams while continuing 
normal transmission of others. This reguirement becomes obvious 
if one considers the case of the simultaneous transmission of two 
data streams to a system for immediate transcription to physical 
I/O devices of different speeds (such as two print streams), lit 
is also an obvious need in the case where one of the transcribing 
devices becomes not ready, and it is necessary to suspend the 
associated data stream. To provide for metering and suspension of 
the flow of individual data streams, a Functio n Control Seque nce 
JFC^i. is add 3d to each trans fission block. The FCS, which is 
receiver oriented, contains a sequence of bits, each associated 
with a particular data stream. The receiver of several data 
streams can temporarily suspend a stream by setting the 
corresponding FCS bit off in its next transmission to the sender 
of that stream. To resume the stream, the FCS bit can be turned 
on. In transmissions from A to B, the FCS sen t by A tells B about 
those streams A wants to receive. The FCS re ceive d by A tells A 
about those streams B wants to receive. 

For error detection and correction purposes, a pjo ck Contro l 
SliS (BCB) is added as the first character of each transmitted 
block. The BCB, in addition to control information, contains a 
module 16 block sequence count. These counts are maintained and 
verified by both sending and receiving systems in order to 
exercise positive control over lost or duplicated transmission 
blocks. 

Transmission blocks are delimited by standard binary 
synchronous communications ccntrol characters (STX, ETB, etc.]!. 
Multileaving also uses the ACKO and NAK control sequences. ACKO 
is used as time fill for handshaking when data is not available 
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for transmission. Normally, handshaking occurs at two second 

intervals. NAK is used as the only negative response and 

indicates that the previous transmission was not successfully 
received. 

Figure A illustrates a typical multi leaving transmission 
block. 
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F i g ur e A 

Typical mul t ile aving transm issio n blo ck 



DLE 

STX 

BCB 

PCS 

PCS 

RGB 

SRCB 

SCB 

DATA 

SCB 

DATA 

SCB 

RCB 

SRCB 

SCB 

DATA 

SCB 

RCB 

DLE 

ETB 



BSC Leader 

BSC Start of Text 

Blcck Control Byte 

Function Control Sequence 

Function Control Seguence 

Record Control Byte for record 1 

Sub-Record Control Byte for record 1 

String Control Byte for record 1 

Character string 

String Control Byte for record 1 

Character string 

Terminating SCB for record 1 

RCB for record 2 

SRCB for record 2 

SCB for record 2 

Character string 

Terminating SCB for record 2 

Transmission block terminator 

BSC Leader 

BSC Ending Sequence 
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Mul^i leaving centre! Jield specifications 

Following is a complete specification of multileaving control 
fields. The reader should keep in mind that not all of the 
capabilities implied by these definitions have been implemented by 
IBM. At the end of - this appendix, specific omissions in the 
implementation are noted. 

§t£ina control By.tj JSCJl 



r ---- — -., 

| OKLJJJJJJ 

7 



Osage: This field identifies the type and length of a 

character string. One or more of such character 
strings represent a record or message for 
transmission 

Definition: c = = End of record (KLJJJJJ=0) 

0=1= All other SCB's 

K « ■ Duplicate character string 

L ■ = Duplicate character is blank 
L * 1 = Duplicate character is ncnblank 
(and follows SCB) 

JJJJJ - Duplication count 

K = 1 = Non duplicate character string 

LJJJJO = Character string length 

Motes: 1. If KLJJJJJ * C and 0=1, SCB indicates record is 

continued in next transmission block. 

2. Count units are normally 1 but Da Y be in an ? 
other units. The units utilized may be indicated 
dynamically in the SRCB or other aethods of 
indication could be designed. 
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£§£2l£ Contr ol B^tj (RGB) 



r — 
I 



I I I T T T T | 
7 



Usage: 



Definition: 



This field identifies each record type within the 
transmissior block* Further, it uniquely 
identifies individual data streams when the 
record types are the same. 

« » End of transmission block (IIITTTT*0) 
0*1 = All ether RCB«s 

III « Stream identifier used to identify streams of 
multiple identical functions (i.e. multiple 
print streams to a multiple printer system, 
etc.) 

Ill * Control information if TTTT ■ (ccntrol record) 

= 000 = Reserved for future expansion 

~ 001 - Request to initiate a function transmission 
(Prototype RCB for function . in SRCB) 

s 010 * Pernission to initiate a function trans- 
mission (RCB for function contained in SRCB) 

= 011 * Reserved 

* 100 * Reserved 

= 101 * Available for 

= 110 ■ Available fcr 

« 111 = General control 
ic SRCB) 



local modification 
local modification 

record (type indicated 



TTTT « Record type identifier 

s 0000 » Control record 

s 0001 = Operator message display request 

* 0010 * Operator command 

« 0011 ■ normal input record 

» 0100 « frint record 

= 0101 ■ Punch record 

■ 0110 = Eata set record 

* 0111 = lerninal message routing request 

= 1000 - 1100 = Reserved for future expansion 

- 1101 - 1-111 * Available for local modifications 
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Sub-RecO£d Con t r,ol B^te .1SRCJE), 



r . ^ 

| OSSSS'SSSI 

7 



Osage: This field provides supplemental information 

about a reccrd. 

Definition: 0=1 (Must always be on) 

SSSSSSS * Additional information - actual content is 
dependent en record type* Several examples 
are listed below. 

SRCB for General control reccrd 



r 1 

I (character) | 

7 



Usage: Identifies the type of generalized control 

record. 

Definition: character = A = Initial terminal signon 

* B » Final terminal signoff 

= C = Print initialization record 

* D - Punch initialization record 
= E = Input initialization record 

= F * Data set transmission initialization 

■ G * System configuration status 
« H = Diagnostic control record 

= I - R ■ Reserved 

■ S - Z » Available for local modification 

SRCB for Print records 



r - ^ 

loacccccci 

L-«- ------------ ---J 

7 



Osage: Provides carriage control information for print 

records. 

Definition: 0=1 (Must always be on) 
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n = « Normal carriage control 
« 1 - Reserved for future use 

CCCCCC = Carriage control information 

= 1000NN = Space immediately NN spaces 

* 11NNNM = Skip immediately to channel NHNN 

* 0000NN = Space NN lines after print 

= 01NNNN = Skip to channel NNNN after print 
= 000000 * suppress space 



SRCB for Punch records 
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L---- ............ .J 

7 



Osage: Provides additional information about punch 

records. 

Definitions 0=1 (Must always be on) 

ss = Punch stacker select information 

B * = Norsal EBCDIC card image 
= 1 = Column binary card image 

M » 00 ■ SCE count units - 1 

s 01 * SCE count units = 2 

= 10 « SCE count units = 4 

* 11 ■ Reserved 

RR = Reserved for future expansion 

SRCB for Input records 



r t 

|OHHBRRRR| 

L— - — .- — — — -■ — J 

7 



Osage: To provide additional information for input 

records* 

Definition: 0=1 (Must always be on) 

M ■ 00 ■ SCE counts = 1 
■ 01 ■ SCE counts * 2 
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= 10 = SCE counts = 4 
= 11 * Reserved 

B * = Ncrnal EBCDIC card image 
= 1 = Column binary card iaage 

ERRR = Reserved 

SRCB for Terminal message routing records 



r ___ 1 

IOTTTTTTTI 

L — - -—— — — — -— J 



7 

Usage: Indicates the destination of a terminal message, 

Definition: 0=1 (Must always be en) 

TTTTTTT = Remote system number (1<T<99) 

» Remote system group (100<T<127) 

= Broadcast to all remote systems (T=0) 
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iJiHSlicn Control S equen ce (PCS) 
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7 8 15 

Usage: . Controls the £lov of individual function streams. 

Definition: 0=1 (Bust always be on) 

S = 1 = Suspend g ill stream transmission (Wait-a-bit) 
(A handshaking response of ACKO implies the 
clearing of this bit,) 
= * Norial state 

T = Remote console stream identifier 

R = Reserved for future expansion 

ABCD...WXYZ = Various function stream identifiers (oriented 
only to recipient.) 

- Normal jrint (or input) = A, B, C, ••• 

- Normal punch streams = Z, I, X, ... 

- Other functions - .... - ... 

Note - a bit on * continue function transmission 
- a bit off = suspend function transmission 

Note: Bits for the print and punch streams may have 
overlapped meanirgs for terminals with multiple 
davices. For example, bit n w" specifies function 
continue/suspend for both printer 5 and punch 4. 
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Bi^cjc Control E^te (BCB) 



i — i 

|OXXXCCCC| 

L — -- — — — -- — — -J 

7 

Usage: 0=1 (Mast always be on) 

CCCC * Modulo 16 block sequence count 
XXX ■ Control information as follows — 

» 000 = Ncraal block 

■ 001 a Bypass sequence count validation 

■ 010 « Reset expected block sequence ccunt to CCCC 
» 011 = Reserved 

* 100 * Reserved 

* 101 = Available for user modification 
= 110 = Available for user modification 
= 111 * Reserved for future expansion 
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Initiating a m ulti^eaying con nection 

The procedure for establishing the connection of computer A 
to computer B is performed as fellows: 

1. A transmits a two character sequence (SOH,ENQ) to 6* 

2. B responds with ACKO. 

3. A responds with the transmission of a block containing 
a single message vhich must be a signon general control 
record: 

DLE,STX,BCB,FCS, RCB, SRCB, signon message, DLE,ETB 

RCB must be 1111CQ00. SRCB must be 11000001. The 
signon message is as defined by system B and dees cot 
appear in compressed form* 

4. Assuming acceptance of the signon by B, noraal 
processing may ensue. (Otherwise, further 
transmissions froi B to A will usually cease.) 

£§.lJL2IJ5ina a &i£& stgeam tr, i ans i B;}.ss;Lo < n j 

The procedure for initiating and performing a data 
transmission from A to B is as fellows. In the example, let X be 
the unique RCB associated with the data stream in question: 

1. A transmits to B a request to initiate a transmission: 

DLE,STX,BCB,FCS,RCB,X,0,0,DLE,ETB 

RCB must be 10C10000. SRCB must be X (the prototype 
RCB for which permission is being requested) • 

2« B responds with a permission: 

DLE,STX,BCB,FCS,BCB,X,0,0,DLE„ETB 

RCB must be 10100000. SRCB must be X (the RCB for 
which permission is being granted). 

3. A now proceeds to transmit the data stream messages. 
(Refer to "Transmission philosophy.") 

4. A indicates end of a data stream (end-of-file) by using 
a terminal message which has a zero SCB for its first 
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SCB. Note that an all blank message cannot be 

transmitted as a null message. 

*NOTE* For console streams, permission is never sought nor 
granted, End-of-file is never used, Cnly the 

processing noted in step 3 occurs. 

!££££ £§l§££i°.i} s\n£ <porr, ectj.cn 

Each transmission block is initially checked using convential 
cyclic redundancy check techniques. NAK is used to request 
retransmission when the check yields an error* NAK is also used 
when no data is received for a period of three seconds. 

Several other logical error conditions can also occur: 

J£5 sequence che ck - Tc iasma that data blocks are received 
in order and that no blccks are missed, the following BC3 
testing is ' done: Let x be the received BCB and Y be the 
expected ECB. 

If X-Y>0 then a block has been missed and a sequence error is 
detected. 

If X-Y=0 then the proper block has been received and it is 
processed. (X is increaented as tah next expected X.) 

If X~Y<0 then: 

a. If 16+X-Y>2, then a sequence error is detected. . 

b. If 16+X-Y<2, then the received block is a 
duplicate ard is discarded. 

If a sequence error is detected, the following transmission 
is used: 

DLE,STX,BCB,FCS,RC3,Z,DLE,ETE 

BCB usually indicates reset tlcck check count, RCB is 11100000 to 
show the error. 2 reflects %hat the expected BCB was (Y 'in above 
example). The receiver of this message may reset his transmitted 
BCB to Z. However, data has probably been lost, and restarting 
the current transmissions cr aborting the connection may be more 
appropriate. 
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Duplicati on £f r eques ts to tran smit - these may be ignored* 
However, the IBM RASP system aborts the connection in this 
case. 

Non-ex^sten^ RGp ,^,s or. prototyp e RGB's - these are ignored. 
Any unprocessed messages in the transmission are ignored. 

Special notes 

Certain features of the multileaving protocol, though 
defined, have not been implemented by IBM. These include: 

1. Record types otter than print, punch, card input, 
console, and contxcl are not supported. 

2. Only the signon general control record is used. 

3. SCB counts other than one are not used. 

4. No "continued 11 SCE's are used. 

5. Mo support for nor-EBCDIC transmissions exists. 

6. Although the protocol allows a mixing of BCB types in a 
given transmissicr block, this is not done in practice. 
Consider messages A, B, C in a transmission block each 
for a different data stream (mixed RCB's). If the 
resources to bardie message A are not available, then 
messages B and C light be locked out as well. Thus, 
data streams B and C are being artificially inhibited. 
By keeping like RCB's in a transmission block, stream A 
could be suspended while transmissions for B and C 
could continue. 
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I. Introduction 

H£.2££0 i£CSSS CDC 8 J£ Option 

As outlined in the Product Requirements of September 25, 
197U, this project will be an option to the currently defined IBM 
HJE component of the HP2000 ACCESS system, a CDC compatible RJE 
component. This HJE function, emulating the CDC 200 User 
Terminal, will provide remote access tc a CDC machine. Concurrent 
with this RJE capability, the I/O Processor will continue to 
support the 32 terminals accessing, the TSB system. 

II. Functional Specifications 

Following the implementation .i these enhancements, two 
distinct functions will exist in the HP2000 ACCESS system. The 
obvious function is the TSB s-f ,, M».e Which will continue to exist 
and operate as in the past. In addition, the I/O Processor will 
be able to function as an BJE station. In this way the HP2000 
ACCESS system may serve an installation for time sharing at the 
same time it provides access to a remote CDC system (referred to 
as the host system) • 

The RJE function will be based on the CDC 200 Oser Terminal 
synchronous telecommunications protocol. It will operate on data 
in the ASCII or BCD codes. Job input to the host is in the form 
of 80 column card image data. Job output from the host is in the 
form of printed lines. Host operating systems generally refer to 
these types of inputs and outputs as readers and printers 
respectively. (There is also input ar.d output in the form of 
console data.) The design of this software, however, is such that 
there need not be a fixed association with physical devices. It 
will be possible through HP2000 ACCESS operator commands to 
designate the actual devices to be used. In addition to real card 
readers and line printers attached to the I/O Processor, data 
streams between the TSB system and the I/O Processor will be 
available. Functioning as ASCII files availaole to BASIC 
programs, these data streams will also be available for 
communication with the host system. Thus, transmission of data to 
the host from a BASIC program might be substituted for 
transmissions from a real card reader. Similarly, output might be 
directed to a BASIC program rather than to a real line printer. 
There will also be BASIC ASCII file access to th^ console data 
streams. Since the CDC 200 User Terminal will operate with 
several CDC host operating systems, no attempt is mads in this 
document to outline host-specific operating procedures • -Appendix 
A 'of this document does provide a list of some CDC manuals which 
may be useful. 
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TSB user s 

The 32 users attached to the TSB system through the I/O 
Processor will continue to utilize th .- system exactly as described 
in the HP2000 ACCESS user's manual. Use of the special ASCII 
files for host communications will follow normal ASCII file rules. 
The names for these ASCII files will be JTO, JLO, J 10, and J WO 
(Job Transmitter, Job Line printer output, Job Inquiry, and Job 
Messages), The term "job" is used by CDC host systems to refer to 
a unit of work performed for a user of such a system* The job 
inquiry and message functions correspond to console input to the 
host and console output from the host respectively. 

Except where nece ;sary, the remainder of this document will 
deal primarily with the p 7" function as it relates to the use of 
real devices. For in l..:. station or the use of the ASCII files, 
refer to appropriate sections of the HP2000 ACCESS user^s manual. 

T SB ope r a t or. 

The TSB operator assumes an added role as a- result of the 
enhancements. In addition tc managing the TSB system, he becomes 
an operator of the BJE station as well. He is both a TSB operator 
and an RJE operator. In this capacity he has these new duties: 

1. Initiate the connection of the system to a host 
CDC system. 

2. Assign input and output devices to the host 
reading and printing functions. 

3. . Operate the input devices in order to transmit 

jobs to the CDC system. 

4. Monitor the line printer in order to separate 
listings and load forms. 

5. Make remote operator inquiries and/or control the 
job flow via remote 0F era<t or commands. 

6. Initiate disconnection of the system from the CDC 
system. 

7. Request a report of communications errors. 

Before describing the- operational details of these new 
duties, it is appropriate to describe the function of the operator 
console. The operator console is physically attached to the 
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System Processor, not to the I/O Processor. Communications 
between the two processors is via a computer to computer 
interconnect kit. Enhancements to the System Processor will allow 
messages (commands or inquiries) destined for the remote CDC 
system to be entered on the System Processors console. These 
will be sent to the I/O Processor via the interconn€ct kit for 
actual handling or transmission. In addition, operator messages 
received from the CDC system will be sent through the interconnect 
kit to the System Processor for display on the system console. It 
is important to note that messages received as a result of TSB use 
(inquiry via JIO) will also be logged on the system console. 

III. Interface Specifications 

In this section, all command., for the RJE function are 
described. Specific responses to each command ar-i discussed. 
However, if the RJE command can not be interpreted as one of the 
legal commands shown, the following error message will be 
received: 

RJE COMMAND EPROR 

Another possible error is the use of commands at inappropriate 
times. Some commands are inappropriate if entered when the RJE 
function is not connected to a host CDC system. If this fact 
applies to a command, it will be noted in the description of the 
command. The following general message is then used in response 
to a command entered at an improper time: 

RJE COHHAND NOT APPROPRIATE 

Note that all commands and all related responses begin with the 
characters "RJE M which allows easy visual separation of RJE 
functional activity from TSB activity. The RJE function will take 
a "back seat' 1 to TSB users if the system becomes heavily loaded 
with work. Should this occur, responses to commands may be 
delayed, and activity on the associated I/O devices may degrade. 
This is done to prevent interference with the TSP user. 

System connection 

If the operator wishes to connect (or r^-connect) the HP2000 
ACCESS system to a host CDC system, he does the following: 

1. Enter the following command on the system 
Processor console: 
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RJE-SC,n,ra (SC=System Connection) 

where n is the site address (octal 160 to 177), 
This number is determined by the host CDC system, 

m is th« code (ASCII, IBCD, or BCD) to be used 
for the duration of the connection to the host 
CDC. Default specifications of n and m will be: 

n=160 
m=ASCII 

Subsequently, they will default to the last 
values uij -d. Either operand may be omitted. If 
n is omifid, the form or the command must be: 

RJE-SC,,m 



After entering this command, the operator may 
receive the message: 

RJE SYSTEM ALREADY CONNECTED 

This message indicates that a previous connection 
is still in effect, Th«* operator may then accept 
this existing connection or force a disconnection 
(see below) and retry the system connection 
described here. 

Normally, the following message will be received: 

RJE SYSTEM READY 

The operator should proceed to step 2. 

2. Ready the communication line. This will 
typically involve dialing the CDC system, waiting 
for an' answer, and then placing the data set in 
data node. If non-switched communications 
facilities are in use (a "dedicated" or "leased" 
line), no action is usually required to ready the 
line. If it is possible for the CDC system to 
call its remote stations and the data set in use 
has an auto-answer capability, the TSB operator 
may elect to ready the communications line by 
enabling the auto-answer, when the CDC system 
calls, the RJE function will then continue 
automatically. 
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3. As soon as the connection has been established, 
the TSB operator will receive this message: 

RJE COMMUNICATIONS ESTABLISHED 

S£2iS§ ass^qflaeflt 

A data source or destination must be associated with each 
host reading and printing function. when the I/O Processor is 
loaded and started, a default assignment of these sources and 
destinations will occur. However, the operator may wish to change 
this assignment from time to tine, so a command is available for 
this purpose. 

Physical devices ittt.-ohed to ...«.- I/O Processor and the TSB 
ASCII files for host communications are designated by a two 
character name and a numbei v.'ssd to distinguish multiple like 
devices: 

CRn - card readers 

JTO - job transmitter 

LPn - line printers 

JLO - job line printer output 

All ASCII file names are numbered relative to zero. Hence, the 
"n" value in these names is also relative to zero. 

Similarly, the individual host reading and printing functions are 
designated as follows: 

HRn - host reading function 

HLn - host line printing function 

For these names, the "n M values start with one. This is to 
provide for better association with the names commonly used by the 
host systems to refer to these functions. 

For completeness 1 sake it should be noted that there also exist 
host inquiry (HIO) and host message (HMO) functions. These 
functions are, however, always associated with the system 
operator's console an.d the Job inguiry/Job message ASCII files. 
Therefore, they are not assignable by operator command. For the 
operator to make a device assignment, he needs to designate an 
association between one of the physical devices or ASCII files and 
one of the host functions. Naturally, some assignments would not 
make sense, for example a card reader with a printing function. 
Therefore, in order to assist the operator in making the proper 
assignments, an "arrow" ("<" or M > M ) is used in ths command to 
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show the direction of the data flow. The general form of the 
command is as follows: 

RJE-DA,hf<d*,v 
or RJE-DA, hf>dev 

where hf designates one of the host functions and dev designates 
one of the available devices. The first form is used to assign 
devices to the reading function (the arrow indicates flow of data 
from the device to the host: RJE-DA, URKCRO) • The second form is 
used to assign devices to the printing function (the arrow 
indicates flow of data rrom the host to the device: RJE- 
DA, HL1>LP0) . 

These assignment :*» un? be mad - ? at any tim?. However, they 
will only become effective t the time the use of a device begins. 
For input' devices, use begins at the time of the SR command and 
ends at the time of a TR command (see below). For output devices, 
use begins with the initial receipt of data from the host and ends 
when that output is complete. Obviously, no use of devices can 
occur except between a system connection and disconnection. 

When the I/O processor is initially loaded, default 
assignments will be made. These defaults are determined by the 
operator at the .lime his system is configured. 

One other form of the command is available to be used for 
display of the current device assignments: 

RJE-DA 

Responses will be of the form: 

RJE hf<dev 
or RJE hf>dev 

where hf and dev are as discussed above. 

Dev ica char ac teristics 

The aforementioned devices have the following 
characteristics: 

Designator PesgrJtPtjoQ V^ax Buf f er si^e Fu.aSl.ioj; 

CRn Card reader UO words read only 

JTO Job transmitter uo words write only 

LPn Line printer 66 words write only 

JLO ' Job line printer 67 words read only 
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JIO Job inquiry 3 6 words write only 

JMO Job message 60 words read only 

For the JL device only r the first word of each buffer is used to 
supply carriage control information to the BASIC program. This 
information is in the form of a carriage control character 
followed by a null character. The actual print data begins in the 
second word of the buffer. Carriage control characters for JL are 
equivalent to those for the BASIC CTL construct. They will 
generally require use of the HUM function in a BASIC program for 
proper use. 

S§&£iS2 QPBrati.ong 

Let us refer to the device .*s«ign«d to the host reading 
function as a reader. Two commands at: available for activating 
or deactivating the reader with respect to the RJE function. To 
attach the reader, the following command is usei: 

RJE-SR1 (SR=Start Reader) 

If the reader is or can be assi.-jt <~d to the RJE- function, the 
following message is received: 

RJE READER1 AVAILABLE 

If the reader is presently active with some other function, the 
following message will be received: 

RJE READER1 NOT AVAILABLE 

To detach the reader from the RJE function, issue the following 
command: 

RJE-TR1 (TR=Terminate Reader) 

As soon as the reader is finished reading any remaining data, the 
following message will be received: 

RJE READER NOT AVAILABLE 

These commands are also generated internally by the system at 
certain points. A start reader command will be attempted 
automatically at the same time as the connection to the host CDC 
is completed. A terminate reader command will be done 
automatically at the same time a system disconnection is done. In 
these cases the appropriate messages will be shown to the 
operator. That is, he will se* the- "RJE PEADER1 AVAILABLE" or 
"RJE READER1 NOT AVAILABLE" message. After th= reader is once 
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started, it is alway.s active and attempting to read. Thus, the 
operator need only ready the reader for the data to be read. This 
action is equivalent to depressing the "LOAD" key on a CDC 200 
User Terminal* 

Since some card readers do not have an "end-of-file" feature, 
it is necessary to use a special card image to delimit the. end of 
a set of data read by the reader. The format of this card is: 

:: (two colore) 

The two colons begin in column one of the card image. The 

accidental appearance of the M :: M image at any point other than 

the end of a s at of data is considered an operator error. If this 
occurs, th* image will be igi.ored. 

Two types of problems may oqcur at the reader which require 
operator attention. One type of problem includes the normal 
physical errors (such as card jams, etc.) and failure to terminate 
a set of data with the "::••■ card image. Should any of these 
situations occur, the following message will be issued: 

RJE READE31 ATTENTION REQUIRED (bell) 

The operator should correct the problem and r-^ady the reader. 

The second problem area is the detection of illegal 
characters in the data read from a card. (This problem can occur 
only with card reader devices.) Only valid Hollerith codes can be 
read and transmitted to the host system. If any illegal 
characters are detected, the reader will halt and the following 
message will be issued: 

RJE READER1 DMA ERROR (bell) 

The operator will find the offending card last in the stacker. He 
may correct the card and replace it in the hoppar, or he may 
ignore the card. After taking either of these actions, he must 
issue the following command to cause the reader to continue: 

BJE-RR1 (RR=Restart Reader) 

All three reader commands (SR, TR, and RR) are inappropriate it 
used when the RJE function is not connected to a host. Use at 
such times will result in the "NOT APPROPRIATE" response. 

One additional RJE command is related to reader operations. 
Occasionally, when using a 200 User Terminal, the host will 
terminate card reading because of some erroneous data found on the 
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cards being read. The usual response is " for the operator to 
correct the deck of cards, reposition the cards in the input 
hopper, depress the 200 User Terminal "LOAD" key, and then enter a 
command to the host to restart reading. Obviously, the use of the 
"LOAD" key is optional, depending on whether card repositioning is 
necessary or not. For this HP2000 ACCESS RJE software, the "LOAD" 
key is emulated with the following command: 

RJE-LO (L0=Load) 

It is intended for use only in correcting problems as noted above. 
The command is not needed to effect any initial reading of cards. 
Use of the command at inappropriate times will result in the 
discarding of any cards already read but not yet transmitted to 
the host. Of course, this is exactly the desired action when 
correcting problems as nets above. 

Two special codes are used in card images for the 200 User 
Terminal. These are the 6/7/8/9 and 7/8/9 punches. Use of these 
codes from a real card reader is straightforward. However, if the 
JTO ASCII file capability is being used, the codes must be entered 
as follows. For the 6/7/8/9 cod*, substitute the extended string 
literal »28. For the 7/8/9 code, substitute the extended string 
literal »30. 

Output Ope rations 

Let us refer to the device associated with host output as a 
printer. Whenever data is ready for transfer from the host to the 
HP2000 ACCESS system, it will be accepted unless some other 
process (such as a TSB user) currently controls the printer. In 
the case of such contention, the RJE function will wait until the 
printer is released by the user before accepting the data from the 
host CDC system. Whenever the RJE function is unable to allocate 
the printer, this message will be issued: 

RJE AWAITING PHIMTER1 

Except to correct errors and to load forms, etc., the 
operators function is largely passive. If any paper jams or 
other "not ready" conditions occur at the printer, the operator's 
attention will be required. In this case, he will be notified of 
the problem with the following message: 

RJE PRINT3R1 ATTENTION REQUIRED (bell) 

A CDC host does not necessarily indicate the end of a print 
operation to the 200 User Terminal. For the HP2000 ACCESS system 
this could mean that deallocation cf a line printar by the RJE 
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function would be delayed. For this reason, two methods are used 
to release the printer. Whenever the host switches from printer 
to console output, the printer will be deallocated. In addition, 
the operator may force deallocation by using the following 

comand: 

RJE-TP1 (TP=Terminate Printer) 

One additional consent about printed output should be made. 
The RJE software allows a maximum of two blocks of print lines to 
be received from the host at any given point in tine. If for some 
reason, the output device (JLO or PRO, utc.) does not dispose of 
this output, degradation of other RJE functions (card reading) may 
occur. However, the operator will always be able to transmit 
console input to the I • st. This generally causes a host to 
interrupt printed output l< i will prevent deadlock situations if 
serious output problems should occur. 

R emote iQ&ujj^ies and Comma nds 

The CDC system generally has available a set of commands and 
inquiries which the RJE operator may use. It is assumed that the 
operator has access to or knowledge of the commands he may use* 
For the TSB operator, such commands and inquiries are entered 
through the System Processor console as follows: 

RJE-RC,m (RC=Remote Command) 

where m is a string of characters making up one 
of the legal CDC commands or inquiries. 

Any responses from the CDC host or any other operator messages 
received at any time from the CDC host will be sent to the System 
Processor for display on the console as follows: 

RJE m 

where m is the string of characters making up the 
message received. 

The RC command is inappropriate if the RJE function is not 
connected to a host. . The "NOT APPROPRIATE" response would be 
received. The "INT" key function of a CDC 200 User Terminal is 
not directly emulated by this RJE software. This is because 
access to the console is always possible even when card reading or 
line printing is active. Thus, the RC command may be used at any 
time. 
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System Disc oj[in gctign 

When the TSB operator wishes to discontinue the RJE function, 
he performs the following steps: 

1. Enter the following command on the System Processor 
console: 

RJE-SD (S.D=S.ystem Disconnect) 

2. Receive the message: 

RJE SYSTEM DISCONNECTED (TYPE n) 

The "n M in the above message indicates the type of disconnection 
that occurred. This mess>ag»: may !>•- r ' *ad at times unrelated to 
the use of an SD command. For example, simply hanging up the data 
set without entering SD first 'foull result in a type 1 disconnect. 
These types of disconnections are possible: 

normal disconnection (always invoked by the RJE 
operator) 

1 line break or other failura in .the communications 
equipment 

2 apparent host failure (no recaption from host for two 
minutes) 

3 power failure 

Following any system disconnect, a new system connection may be 
performed. Any repeated use of this command will result in a 
repeat of the above response. 

Communications Err ors Report 

To aid in observing communications lina quality, a report of 
communications errors may be requested as follows: 

RJE-ER,R (E8=Error Report) 

where R is an optional parameter described below. The following 
report will be received: 

RJE n1 ERRONEOUS STATION ADDRESSES 

RJE n2 ERRONEOUS CONTROL CODES 

RJE n3 CHARACTER PARITY ERRORS 

RJE nU MESSAGE PARITY ERRORS 



5- 63 



RJE n5 CARRIER LOSSES 

RJE n6 MISSING WRITE CONTROL CODES 

Each n is a count of the particular error. Counters may 
optionally be reset to zero when the report is requested by 
specifying the R (reset) parameter. The error types are: 

ERRONEOUS STATION ADDRESSES — the station address contained 
in the message was incorrect or for a non-existent station. 

ERRONEOUS CONTROL CODES — an invalid opc-ration from the 
host. 

CHARACTER PARITY ERRORS — bad parity on a received 
character. 

MESSAGE PARITY ERRORS — LRC character is incorrect. 

CARRIER LOSSES — carrier on signal dropped before ASCII end- 
of-text was recognized. 

MISSING WRITE CONTROL CODES — write message with no E1, E2 # 
or E3. 

This command may be issued at any time and as often as desired. 

Command £au,ses 

A real 200 User Terminal uses a CRT for display of console 
output. This is obviously a much faster device than the HP2000 
ACCESS system console. The CDC host, not aware of this problem, 
could flood the TTY console with output. For this reason, the RJE 
software introduces pauses which allow the operator to enter 
commands. This is, in most cases, an action analogous to the 
effect of the W INT M key used at the 200 User Terminal. The pauses 
are approximately 15 seconds long. 

If a power failure occurs, some or all of these things will 
happen: 

1. The communications equipment (modem) may lose power. 

2. Terminal ready signals from the computer to the modem 
will drop. 

3. The host system will be unable to communicate with the 
RJE function of the HP2 000 ACCESS system and will 
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initiate error recovery procedures. This typically 
involves disconnecting the attached remote station* 

For these reasons, if the BJE function is active at the time of a 
power failure, a system disconnection will be performed on a 
restart following power failure. 

IV. Operating Specifications 
£&I&£3££ Requirements 

The HP2000 ACCESS RJE component requires the following 
hardware: 

126 18 Synchronous Jata Set Ir.' <-er£ace Kit 

Inst ructio ns f oj: £oadin<2 

The I/O Processor is configured and loaded by the I/O 
Configuration program. 

V. Appendices 

Appendix A — Representative list of useful CDC manuals 
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Append ix A 

Representati v e list of usef u,l CDC manuaj^s . 

For information regarding the CDC 200 User Terminal, refer to 
the following manual. It contains a description of the terminal 
hardware and general operating procedure's. Analogous capabilities 
have been included in the HP2000 ACCESS RJE component* 

CDC 200 User Terminal (Publication No. 82 128000) 

For CDC host system operating information related to the CDC 
200 user Terminal, refer to the following manuals. In most cases, 
these manuals will contain further references to other useful CDC 
literature. 

Computer Systems Reference Manual (Publication No. 60100000) 
INTERCOM Reference Manual (Publication No. 60307100) 
SCOPE 3.4 Reference Manual (Publication No. 60 307200) 
KHONOS General Information Manual (Publication No. 60407100) 
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S ynchr on ous Communicatio ns Handler 

Descr i ption a n ^ function 

The synchronous communications handler (SH) manages all I/O 
on the communications line. Once activated, it manipulates and 
controls the transmission and receipt of data within the defined 
COC U200 Communications protocol* SH is activated at the request 
of the operator via the RJE-SC command. Activity then continues 
until an RJE-SO command or abortive communications line error 
occurs. SH will report data regarding line condition to the 
operator when directed to do so with RJE-ER. 

The U200 provides f r the s\i[>\ ort ot one card image input 
stream, one printer ima/: output .stream, and remote console 
operator input/output streams. T ^e in^ut streams are managed via 
two distinct SH input work, queues. Communications between SH and 
its data producers and consumers follows conventional handler work 
queue exchanges. 

when a system connection is made, handlers -acj enabled to 
either produce data (input streams) or consume data (output 
streams)* SH then interlaces with the host system via the U200 
protocol in order to control the flow of data appearing on these 
queues. Additional information about the U200 protocol may be 
found in the D50CO synchronous driver base design. 

X&terjacjng 

SH interfaces directly with the console I/O handler as 
follows: 

1. SH accepts the SC, SD, and Efi commands at any time and 
the LO command during an RJE session. These must 
appear in console buffers and on the SH control work 
queue. 

2. SH places messages on the console I/O worJc queue via 
.CCO. 

SH interfaces with any one of its input modules as follows: 

1. SH places a »SH running 1 message on the handler's work 
queue. This message informs the handler of current SH 
parameters and indicates that tha handler may proceed. 
Contained in the message are: 
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Queue name - name of SH input work queue on which the 
handler is to place its data blocks, 

2. SH accepts data blocks from the handler on the 
specified work queue, (A BCW definition for the final 
block in a series of blocks is adhered to by the card 
image input handler.) 

3. SH may purge the handlers work queue if an abortive 
line error occurs and will definitely purge when a 
normal disconnect occurs, Tue handler should view this 
as an 'SH not running 1 signal, 

4. SH will place i Til command (in a console buffer) on the 
handler's work ji. me if a .--Ljiioff is to occur. (This 
is net true for the console input handler.) 

5. SH will purge the card compression handler's work queue 
when it receives an LO command. It will the place an 
"SH runniny" message on the card compression handler's 
queue to restart the reader. 

SH interfaces with any one of its output modules as follows: 

1. SH places data blocks on the handler's work queue, 
When the handler disposes of a block, it must be 
returned to SH to signal a reduction in that handler's 
queue level. 

2. SH may purge the handler's work queue if an abortive 
error occurs and will definitely purge when SH performs 
a signoff. This should be viewed as a signal to 
quiesce. 

3. SH will place a TP command on the printer output work 
queue if it has been active and the host starts writing 
to the console instead of the printer. 

These local data are used by SH: 

CTIQ holds control queue name 

CQENT holds address of current work entry from prime gate 

DQENT holds address of current work entry from I/O completion 
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SIQSfl indicates current host communications activity 

SIO I/O activity flag 

Definition of • SH running 1 message which appears in a control 
buffer: 

BCW Word 2 Bits 15-4 Zero 

3-0 command=3 
Word 3 Bits 15 (unused) 

14-0 Queue name (SH 

input work queue) 

**tfote** this message * < allays pla^d on the recipient 1 *? work 
queue using .PHIQ (prior, c. . PUTQ)7 

Definition of 'end-file 1 flag tor blocks appearing on input 
work queues: 

BCW Word 2 Bits 15-4 (unused) 

3-0 com:u.and=2 
Word B Bits 15 0=*not end-fil* 

1* end -file 

Definition' of messages given to output handlers by SH, 
Message appears in a communications buffer: 

BCW Word 2 Bits '15-8 device escape code 

("E M code) 
7-4 (unused) 
3-0 comma nd s 1 

(data block) 
Word 3 Bits 15 (unused) 

14-0 Queue name for 
response 
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The responses to SH by output handlers must follow these definitions: 

BCH Word 2 Bits 15-8 device escape code 

("E M code) 
7-4 (unused) 
3-0 command=2 

(data block finished) 

Word 8 Bit 15 for console output handlers 

only, this bit set indicates 
that a command pause has been 
terminated by console input. 
SH uses the indication to 
suspend console output until 
after the console input 
transmission. 

When messages are gueued for the console I/O handler, these 
BCH definitions are made. Their purpose is to allow console I/O 
to note the running state of SH: 

BCH Word 2 Bits 15-14 00=normal message 

U1=communicaticns 
established 
13-4 (unused) 
■3-0 command=1 
Word 7 15-0 massage length 

Tables are defined which contain appropriate data regarding 
each input and output stream. 
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For input the 
defines each stream: 



Synchronous Transmit Stream Table (STST) 



STST entry - console input 
1 - card reader 



STST entry format: 




The Sychrohous Sac* 
possible output stife"am7 



15 Permission to transmit requested 

14-2 {unused) 

1 • SH running* message needed 

permission to transmit granted 
1 C (unused) 

1 ■■; Q ii .»!]• name 

15-8 Queue depth limit 

7-0 Stream Escape Code 

15 {unused) 

14-0 Queue name for producing handler 

ve Stream Table (SRSTy defines each 



SRST entry - console output 
1 - printer 



SRST entry format: 

worj 




Bits 
~15~ 

14-2 

1 


15 

14-0 
15-8 



7-0 
15-0 



C2ntan.ts 

suspend console output 

pending a console transmission 

(unused) 

handler suspended because of g depth 

{unused) 

(unused) 

Queue name for consuming handler 

Queue depth limit (the maximum number 

of blocks which will be received prior 

to suspending the stream via PCS) 

Stream Escape Code" 

(unused) 



Algor,|th(n 



Two local data structures are of special significance. These 
are the Synchronous Transmit Streams Table. (STST) and the 
Synchronous Receive Streams Table (SRST). The entries in the STST 
define the possible input work queues. The entries in the SEST 
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define the possible output work queu^o. Contained in the tables 
ar? all parameters (flags, queue names, etc.) needed to use these 
queues plus all parameters nesied tu control the producers and 
consumers of these queues. Entries in these tables are used 
sequentially in a priority fashion. For example,, the STST is 
ordered as follows:: console input, then card input. Thus, the 
console will always have greatest prioLity. SR5T entries are used 
in a similar manner* 

To insure availability of communications bufters in order to 
prevent deadlocks and insure performance, four communications 
buffers are an assembled part of SH. These four buffers are 
interlocked to SH with the 5M conrol queue name in 3CW word 3, 
The buffers are managed within SH using a simple linked list for 
free buffers. All I/O with the CDC ho^t is scheduled into and 
from these bufters. They, are given to the data producc-rs (console 
input/card input) and consumers (console output/printer output) by 
SH, and these handlers always return tne buffers to SH. SH 
attempts to double buffer to the printer and from the reader but 
will always hold one of the buffers in reserve fcr console 
communications with the host. In this way, the operator is 
assured that he can intervene at any time. 

The system initialization entry point to SH is SYNIII. . The SH 
control queue name is found and saved in CTLQ. Finally, SYNHI 
"configures" SH by initializing the STST and SHST tables. This 
involves issuing a .FIND for all wcrk queues for associated 
producers and consumers. The table entries are then initialized. 

The prime entry to SH is SYNHP. SYNHP consists of three main 
sections. The first is the entry point section which removes work 
from the control queue and invokes processing of the work entries. 
Section two consists of a group of processing sections, each of 
which processes a control queue work entry. The third section is 
an I/O scheduler which is also used by the I/O complete entry 
point to SH. The I/O scheduler performs the task of examining the 
STST entries for transmission or other I/O scheduling. 

A second prime entry point to SH is SINHP. This entry point 
receives control whenever any data is placed oh either input 
stream work queue (console or card transmissions) . The SH 
response is to enter the I/O scheduler for possible I/O 
initiation. 

SYNHP is entered by a system prime. It then invokes 
processing of each work entry found on the control work queue. 
The routines which handle these wcrk entries all return to a 
common point where the current work entry is released tc its 
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buffer pool if appropriate. Other work queue entries are 
processed in turn until none remain. . At this point the I/O 
scheduler is entered for possible I/O initiation. 

These messages may appear on the SH control work queue: 

LQ# §£# SJJ# 9£ SI comma nd s - the command is received from the 
console -I/O handler and is processed by routine SHJEC. The 
work entry is in a console buffer. 

empty ou tput buffer, - this is a communications block which 
was previously received, has been disposed of via cne of the 
output work queues, and is now being returned to SH by the 
associated consuming handler. Its function for SH is to 
signal a reductic; n the n»imL--r of blocks on that output 
work queue. SH uses this technique to monitor the flow of 
data and use of communications buffers. SQCHK processes 
these entries and then returns the buffer to the SH free 
buffer list. 

3LE&£ communications buffer, - communications buffers released 
due to purge processing at system disconnect Lime are added 
tc SH^ free buffer list. SCOMB processes this, work entry. 

allocated! ' console bugler. ~ received from the buffer manager 
in belated response to some previous request for a console 
buffer. SCONB processes the entry. 

lilS£I^,£^ cont rol buffer - received from the buffer manager 
in belated response to ~a~ previous request for a control 
buffer. SCTLB processes the entry. 

work entry processing by SYNHP is as follows: 

SQCHK - locates the SRST for the associated output stream and 
determine the current Q dwpth. If the stream is. £21 
suspended, release the buffer. If the stream is suspended, 
decrement the count and use this buffer to signal "go ahead" 
to the host. 

gCQHB - the buffer is added to .tht- tree buffer list. 

SCT^IfB - if the system is not online, the buffer is released. 
Otherwise, it is supplied to SHBUN for the issuance of "SH 
cunning" messages to available producers of input work queue 
data. 

1 SCONB - Tne buffer is supplied to .CCO. for console output. 
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SRJEC - for an ER command, the data is acguired and the 
Messages are constructed and issued. For an LO command, the 
reader handler is purged and restarted (with M SH running") to 
effect a fresh card transmission. 

For an SC command: 

1. If SH is online or not online but engaged in going 
online, the •SYSTEM - ALREADY CONNECTED 1 message is 
issued. 

2. If SH is not online ana is not going online, the SC 
data station address and rao^. are processed. Then the 
signon activity signals aire set, the •SYSTEM READY 1 
message is is.. :ed, and the data line enable I/O 
operation is started. 

For an SD command: 

1. If a signoff is already in progress, the command is 
ignored. 

2. If SH is not online or engaged in a signon, the 'SYSTEM 
DISCONNECTED* message is issued. 

3. Signoff conditions are established and a disconnect is 
forced immediately. 

All I/O scheduling (except for the initial data link enable 
and terminal clear) is performed by SIO. SIO is entered by SYNHP 
when control work gueue is exhausted. SIO is also used by SYNHC 
to initiate successive I/O operations. If I/O is active when SIO 
is entered, it exits to the central system commutator. Otherwise 
it performs the following seguence of steps: 

1. If SH is no ionger online, SPRGE is entered to clean up 
all queues, etc. 

2. Now SIOSH is inspected to determine if the host is 
waiting on input. If not proceed to step 3. Else: 

A. inspect the input work queues (console first) for 
a data block to transmit. If none is found, then 
issue a read reguest. 

B. initiate transmission of th» first available data 
block and assign new communications buffer to the 
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reader. If an end of file is indicated the STST 
transmit permission flag is cleared, then exit. 

3. If no work queues are active and a signoff is pending, 
a disconnect is performed. Otherwise, a read is 
issued* 

STfNHC is the I/O complete entry pcint to SH. It processes as 
follows: 

1. I/O activity flags are cleared. If any abortive error 
has occured, SPRGE is entered to clean up* 

2« If the open* ion completing is a disconnect, SPRGE is 
invoked. 

3. If the operation is a successful connection, SH is 
placed online and the 'COMMUNICATIONS ESTABLISHED* 
message is issued. If a signoff has been requested, 
the disconnect section of SIO is invoked. Otherwise, 
the 'SH running' control signals are issued to all 
associated input handlers using SHRUN. 

1« If it is a completed transmit/receive sequence, the 
request type is then examined. 

A« if the host is requesting input, set SlOStf and 
enter SIO. 

B. if the host has output data, locate the SRST 
entry and enque the data block to the appropriate 
handler's work queue. Then if q depth limit has 
- been reached set the suspended flag and exit. If 
the maximum depth has not been reached, tell the 
host to go ahead by: 

a. transmitting a pending console message. 

or 

b. acquiring a communications buffer and 
initiating a transmit/receive operation. 

Then exit. 

5. If the I/O event is an ALEFT or an unsolicited attempt 
to write by the host, a communications buffer is 
acquired and a receive only operation is scheduled. 
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SHHON is a subroutine used to present signals to associated 
input handlers informing them of SH activity and parameters. It 
searches for marked STST's requiring this signal, and transmits a 
message to the handler containing its intended input work queue 
name. SHRUN is invoked either by SYNHC following a signon or by 
SCTLB in belated response to the request for control buffers. 

SPRGE purges all input and output work queues and associated 
handler queues. It resets SH to initial conditions, and issues 
the •SYST3B DISCONNECTED 1 message. Finally, it clears the purge 
indication from all SH work queues, closes the SH prime gate, and 
exits. 
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Car d reader .compression handler 

Description an d function 

This handler (CRC) allocates and manages a card reader 
handler or other similar data source in order to pre-process the 
card data for the synchronous communications handler. Pre- 
processing involves blocking card images into the acceptable 
communications format. CRC is a level 2 function handler, and its 
interfacing to a card reader handler follows the level 2 - level 3 
protocol. 

Interjacent 

CflC utilizes its al.\ ted readf »3 follows: 

1. A start buffer is j. laced on the reader's work queue to 
initially activate it or to reactivate it. The form of 
this buffer is as prescribed by the level 2 - level 3 
protocol. 

2. Allocated reader buffers are accepted from the card 
reader handler. They are set with a read command and 
returned to the card reader handler* These same 
buffers return as writes to crc with useable data. 
They are always given back to the allocated reader as 
reads except when terminating, in which case they are 
freed. 

3. Error commands from the allocated reader are used to 
report the error to the operator. For hardware error 
types (type 1 or type 2) , a retry command is 
immediately sent to the allocated reader. For a type 3 
data error, the retry is signalled by the operators 
use of the RR command. This also then results in a 
retry command being sent to the reader. 

4. CBC sends a stop command to the allocated reader when 
CRC is deactivating due to a TR command or synchronous 
handler disconnect. 

CRC interfaces with the synchronous handler by: 

1. Placing blocks of card images on the work queue 
indicated in the • SH running* message. 
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2. Ead-of-file signals from the reader are indicated to 
the synchronous handler as prescribed by its base 
design. 

jtfQcal data s£rjjctures 

The following symbolic names are associated with the local 
data structure used by CBC. 



CCQNM 
CCFLG 



CCBDB 
CCSHQ 

CCCCB 

CCCBP 
CCQLH 

CCRET 



holds the work queue name for the active function 
handler 

contains several flags: 

CCSHB synchronous ...uiler status (*=running # 
0«not active, -=running but CRC is at queue 
limit) 

CCPCB set = ok to process card data 

CRDTA set = all resources available 
(communications buffer and not at queue 
limit) 

CCEOF set = at end-of-file with not ready reader 

CCTBC set = TR command is pending 

holds queue name of allocated reader 

holds queue name to which compressed data is 
delivered 

holds address of communications buffer 

current position within communications buffer 

holds queue limit for maximum number of buffers 
to place on CCSHQ 

holds return address for delayed returns from 
subroutine CGCB 



No buffer definitions are forced by CRC. It conforms to 
those required by the synchronous handler and the level 2 - level 
3 protocol. 
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CHCHI is the system initialization entry point to CHC. The 
only function performed is to .FIND the CRC work queue name. This 
name is stored in CCQNH* 



CRCHP is the prime entry to CRC. 
processed include: 



Work queue entries 



££ SlWl&gg " a signal from the synchronous handler that it is 
running. This message is received in a ccntrol buffer and 
informs CRC that it nay initiate processing at any time. CRC 
will not do any vork until this message is received* In the 
message are parameters needed to operate: name of the queue 
to receive data fro..: % C. CRC is designed to include SR 
command processing as an inherent part of the • SH running' 
sessage processing* 

JIx JJU. lEUi £J£ comm ands - these messages are received from 
the console I/O handler as operator requests to activate and 
control use of a reader. These messages are not valid unless 
preceded by an 'SB running 1 message. 

Reader data, - card images from the reader allocated by CRC 
are blocked and placed into the communications buffer* Error 
indications from the reader are also processed* 



£jjx£&& gagas - tA 

synchronous handle 
termination proced 
allocated reader, d 
next V SH running' 
to the reader as a 
to CRC later* B 
this time are relea 



e CRC work queue can be purged by the 
r due to abortive errors or normal 
ures* In any case, CRC deactivates its 
eallocates same, and quiesces until the 
message is received* A stop command sent 
part of purge processing will also return 
uffers returned by the allocated reader at 
sed. 



£2U£l2lx co ns ole r a 
received from the 
requests for buffer 



Hii SSSaaaiSiilSBS £aliis£S " these may be 
buffer manager in belated response to 



Allocation and management of the card reader handler ia 
affected by three sources: activity signals from the synchronous 
handler, operator directives and device status signals from the 
card reader handler itself* The synchronous handler informs CRC 
(as veil as other nodules) that it is functioning by placing an 
f SH running* work entry on the CRC work queue. only when this 
signal has been processed can other signals be affective. 
Similarly, a purged CRC work queue (purging dene by the 
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synchronous handler) indicates that the synchronous handler is 
ceasing to function. 

Between the "running" and "purged" signals, operator 
directives (Start Reader, Restart Reader, and germinate Reader) 
are accepted. Note that the synchronous handler connect ion~signal 
internally causes an SB command to be processed. A purge signal 
also implies a TR command. The SR command causes an allocation of 
a card reader handler to be attempted. A message indicating the 
result is issued in either case. If successful, initial 
conditions are established and a start buffer is acquired. This 
buffer is put on the card reader handler work gueue with ASCII 
reading mode and the CRC naae indicated. This will activate the 
card reader handler as described in its bass design. An RR 
command is routed to the allocated i-ader for actual handling. 
The TR command inspects a CRC activity indicator and either 
deallocates the associated handler immediately if no cards are 
being processed or flags the TR condition to be effected at end- 
of-file. 

Once allocated and started, the received card images are 
added to the communications buffer after being compressed using 
the .COUP module and put on the associated synchronous handler 
work queue. Two problems can interrupt this flow. Hhen a 
communications ' buffer is not available, an indicator of this 
condition is set. If a card image appears on the CRC work queue 
prior to the needed communications buffer, that card image is 
replaced on the CRC queue (via .PRIQ) and the CRC handler exits 
after closing its prime gate. This prevents further processing of 
card images until the needed communications buffer becomes 
available. Any errors indicated by the card reader handler to CRC 
will result in the issuing of an error message. An end-of-file 
signal is prorogated through to the synchronous handler. 
Following the processing of an end-of-file, the TR flag is 
inspected and appropriate action is taken. Read buffers are 
always returned to the allocated reader immediately following 
processing of the data in them. This technique insures that a 
read operation is continually being attempted and is the way in 
which the "hot reader" feature is implemented. 
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££i££er P.£CO,mEre sslon Handler. 
Description ftfld function 

The printer decompression handler (PD) has as its sain 
responsibility the transformation of compressed data blocks from 
the synchronous handler to print lines vhich are passed to the 
appropriate level 3 handler* It is also responsible for 
performance of the following control functions: Accept printer 
allocation requests and perform the desired allocation, printing 
the RJS AWAITING PRINTER 1 message if necessary. Accept disconnect 
requests and force printer disconnection* Accept printer error 
notices, produce ATTENTION BEQUIF.ED messages, and notify the 
synchronous handler of the printer error. Accept device end-of- 
file notices and relea^i* che d evict. This handler does not have 
an I/O Complete section, since it does not issue IOC calls* The 
module is coded in a "serially reusable" fashion, with all locally 
used data accessed from a unique storage block* Thus, additional 
printer streams may be added by replicating this storage block* 

interf acing 

PD interfaces with the level 3 handler as follows: 

1* A start command is placed on. the level 3 handler's work 
queue to activate it* 

2* Allocated print buffers and emptied print buffers are 
accepted from the level 3 handler* These are filled 
with decompressed data and given to the level 3 
handler* At termination they are freed by PD* 

3* Error message buffers from the level 3 handler are used 
to report error conditions to the operator* 

<*. A stop command is sent to the level 3 handler at end- 
of-file or synchronous handler disconnect* 

5* A command type 9 is sent to the level 3 handler to 
initiate timed retries when the printer is not ready. 

PD interfaces with ths synchronous handlar by accepting 
blocks of compressed data for the printer or punch* 

No BCW definitions are made by this handler. It conforms to 
those defined by the synchronous handler and printer handler. 
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Algorithm 

The detailed processing algorithm is given in flowchart form. 
A summary of the algorithm is giv^a below. 

A significant feature of the inputs to the routine is that 
they include a mixture of normal messages entered by . PUTQ calls 
(print blocks, purge queue request) and priority messages entered 
by . PBIQ calls (printer error, printer EOF, and buffer messages). 
As a result, upon entry to the handler the queue must be inspected 
to detect priority calls. Hence, a . SEEQ call is used to create a 
latch to different message processors* These message processors 
are discussed below. Wh«u a processor has finished it will 
execute a .GETQ to remove its entry and return to the .SEEQ latch 
or .COH. # depending! on the /pe of processing performed. 

DISCO is entered for purge-queue requests, which enly result 
from a communications disconnect. If a device is allocated, the 
routine deallocates the device, issues a stop command to the level 
3 handler, releases any unused buffers, and resets local storage. 

ALLOC is entered for printer allocation requests. If the 
printer is already allocated to this handler, the routine waits 
until the printer is deallocated before it attempts another 
allocation* Otherwise the routine attempts to allocate the 
device, sends an "AWAITING PRINTER" message to the console, if 
necessary, and sets a timer loop to retry allocation. A 
pathological case of special interest is when a buffer cannot be 
obtained for the console message. In this case the entry latch 
for the routine is reset to allow no further actions until the 
buffer is received as a message. This technique is used elsewhere 
in the handler, but is not further elaborated in this document. 

PRBLK is entered for print block queue entries. If a print 
buffer is received and a printer has net yet been allocated, ALLOC 
is entered to perform the allocation. If a printer has been 
allocated, a buffer is obtained from the free list and entry is 
made to . DCOM to decompress lines for output. The routine also 
sets carriage control, if necessary, and then ships lines to the 
level 3 handler. It is also responsible for indicating print 
block processed to the Synchronous Handler when finished. Again, 
suspension may occur due to unavailability of a buffer, and the 
latch-restart technique is used to continue processing. 

PRFLT is entered for printer faults. When the printer is 

not ready, PRERR issues an "ATTENTION REQUIRED" message to the 

console. Again, a latch-restart for buffer not available 

suspension is used. 
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PfiEOF is entered when the stop command is returned by the 
level 3 handler. All print or punch buffers are freed by PD and 
the device is de-allocated. 

PHBUF is entered for buffer messages. It stores the buffer 
message to allow proper operation of the latch-restart routines 
and then goes to .SEEQ to allow continuation of the suspended 
operation. 

The only other entry to this handler is the initialization 
entry. This simply calls .PINO to find its own queue name for 
future reference. 

^uJd module, d es cript i ons 

PDCC is the functional module if; the handler which receives 
control after a printer buffer iu obtained and determines the 
carriage control character to insert in the buffer. Print-then- 
space mode is always utilized by this handler, so control is 
always executed before printing. 
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.COMP - compression service 



De scri ption a&d func ti on 

•COMP prepares buffers of card images for transmission under 
the CDC U200 protocol. 

Interfacing 

The routine is entered via a JSB with the parameters in 
registers and following the call. It returns a value ir, a 
register. The calling s : «n«(ice is as f: 3 lows: 



LDA 


<from addr> 


LDB 


<froa length> 


JSB 


• COMP 


DEF 


<to addr> 



<from addr> is the byte address or the data -to be added to 

the buffer. 
<from length> is the number of bytes of data in the record to 

be added to the buffer.. 
<to addr> is the byte address of the destination buffer. 

This address must point to the first available 

location in the buffer.. 

Upon return, the B-register will contain the byte address of 
the next available location in the destination buffer. 
Compression consists primarily of moving the card image to the 
destination buffer. The occurance of 200 User Terminal end-of- 
recdrd or enl-of-file codes in the first byte of the source card 
image are encoded with the proper preceding escape code before 
moving the card image to the buffer. 



iPCOq - decompression service 

Descri ption aji£ iaqsfrjgfl 

. DCOfl provides a data decompression service to expand CDC 
compressed records into uncompressed format for unit-record 
devices. 
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Ifiterf asincj 

The routine is entered via a JSB with calling parameters in 
registers and following the call. It will return two values in 
registers. The calling sequence is: 

LDA <from addr> 

LDB <to addr> 

JSB . DCOH 

DEC <buffer length> 

<from addr> is the byte address of the data to be 
decompressed. This must be the address of the 
first character following the format control 
character 

<to aidr> is the byte address of the destination of the 
decompressed **«*»■ 

<buffer length> is the positive byts length of the buffer to 
receive the decompressed record. 

Upon return the registers will contain the following: 

A-register: length of decompressed record (pt if EOF record) . 

B-register: Pointer to next format control character in 
source buffer. 

N ot e: If there is more data-in the compressed record than is 
available in the buffer, excess data will be truncated* The 
length returned will never be greater than <buffer length>. 
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NOTE: This document assumes knowledge of tae HP2000 ACCESS Queued 
IOC module and Control Data Corporation's (CDC) telecommunications 
protocol used with the 200 User Terminal (200UT). Th* following 
CDC manuals are recommended fcr additional information on the 
protocol. These manuals describe in detail the actual hardware 
emulated by this software. 

200 User Terminal Hardware Reference Manual (Pub. No. 821128000) 
217-2 Equipment Controller (Pub. No. 82120100) 

I. Product Identification 

Product Abs tract 

The D50CD driver into*.!., ei; 2100 c Ties computers to a remote 
Control Data Corporation CPU via a dial-up or dedicated 
communications line. The line discipline is bit serial 
synchronous and the link protocol is that employed by the CDC 200 
User Terminal. The driver assumtrs the use of the 12618 
synchronous interface kit. 

II. Design Overview 

.Design, assumptions 

Th* program requires the microcode designed for use in the HP2000 
ACCESS I/O Processor. The driver also requires the D.U3 time base 
generator driver. 

NOTE: In order to avoid loss of characters on input/output 
operations, the interface boards should be placed at a relatively 
high interrupt priority. This does not mean the driver uses a 
large portion of available CPU time, indeed only a few percent of 
CPU cycles are taken by D50CD. It does mean that the interrupts 
do need to be processed quickly. 

J2fifiiaJ» ■ SttWUrjt 

D50CD is an input/output driver designed to operate in the HP2000 
ACCESS I/O Processor. The following functions will be performed 

by C50CD. 

I, 

1. CLEAR resets all status words. Puts I/O board in M on- 

hook" condition. 

2. READ Accept a ! block of data from the host system. 

Error d3tecticn and reporting to the host are 
automatically handled. 
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3. WRITE Send a block of data to the host. As in the READ 

operation, error detection and reporting to the 
host are automatically handled. 

4. ENABLE Allows the communications line to be established 

by answering the phone or by operator manual 
dial. Certain operating parameters are passed to 
D50CD via the ENABLE call,. 

5. EXTENDED STATUS - Accumulates statistics on device 

performance during a terminal session. 

NOTE: The WRITE operation may be either a straight write to the 
host or a write/read; in the case of a write/read operation, after 
data is written to the host, the buffer is used to receive data 
from the host. 

££sian approach 

The driver is composed of two fundamental units; the 
initiator section and the continuator section. Each of these two 
sections is further modularized to handle the various driver 
functions. Each module performs some specific function ("read" or 
"write") or common "service functions" (code conversion, establish 
synchronization, send character, receive character, etc.). 

The initiator section sets up service requests for the 
continuator section. The requests- are for either input (read) , 
output (write), or output/input (write/read). The continuator 
section receives messages from the host and when possible, 
satisfies the requests made from the initiator section. It must 
be noted that the driver is responsible for maintaining the line 
protocol. It is the responsibility of the calling program to 
ensure the proper message content and sequence; D50CD has no 
knowledge of the message content. 

When a request is made from the calling program to the 
initiator section of D50CD, a check is made to see if there is a 
pending request. If so, the call is rejected. If there is no 
pending request, the request is passed to the continuator section 
for action. (Passing the request consists of setting flags in a 
common data structure. Obviously, this must be done in a -disabled 
state. ) 

The continuator section of 050CD monitors data source (host 
system) messages and polls and satisfies the initiator section 
request appropriately. In the case ot an input operation (read), 
the' continuator acknowledges any host write operation and fills 
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the caller's buffer. In the case of an output (write) operation,, 
the data is sent to the host on the next POLL. In all cases where 
there is no input buffer, host write messages are rejected. 
Likewise, when there is no output buffer, host POLLs are rejected* 

For a complete understanding of D50CD, the operation of the 
continuator section of the driver must be understood. It is here 
that rncst of the emulation of the 200 User Terminal communications 
protocol is done. The operation of the continuator or interrupt 
handler portion of D50CD is completely independent of almost all 
other activities in the system. It is totally interrupt driven 
and communicates with the host system all by itself, even when no 
I/O has been requested by the calling program. This interrupt 
handler switches bad-- *nd forth between transmissions and 
receptions, controlling bo_. interfac. uoards as required. 

All activities begin at the label INP0T where receive 
operations are initiated. A real 200 User Terminal is normally in 
a receive mode, waiting for the host to indicate the next desired 
action. That is, the protocol is a polling/selection type of 
protocol # and, therefore, the terminal (driver in this case) must 
be directed through each action by the host. During any of the 
actions being performed asynchronously by this interrupt handler, 
the initiator section of D50CD may cause various buffer addresses 
and lengths, etc. to be set. These will be noted by the interrupt 
handler for action at appropriate times. 

When a receive operation from the host begins, the common 
message header is first analyzed character by character. It the 
incoming message contains a site address other than the one 
designated in the ENABLE operation, the reception is ignored. 
This would make multidrop operation possible. Normally, however, 
the message is accepted, and the message control code will be 
detected. This causes dispatching of a routine designed to handle 
each incoming message type. 

RQkk "" If tne initiator section has scheduled a read operation, 
then it is out of phase with the nost. Such a read is terminated 
with EQT status of 1. (This feature of the driver allows the 
calling program to attempt to anticipate host input at times when 
no other I/O is indicated.) If the initiator section has scheduled 
a write operation, the correct message header is transmitted to 
the host, followed by the data supplied by the caller. Finally, 
the trailing ETX and message parity codes are transmitted. If the 
calling program has indicated a write/read operation, the read is 
now enabled. 
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U1I2S — Diagnostic writes froa the host are not supported by this 
driver. All other forms of write messages are processed 
identically. If the calling program has not scheduled a read 
operation, the incoming message is still scanned to determine the 
associated "E" code* This is then passed to the upper level 
program in the form of an unsolicited event. Then the host is 
responded to with a REJECT message. However, if a read operation 
is active, the incoming data is buffered ar»4 checked. If no 
errors occur, a completed I/O operation is returned via •BUFR. 
Then the host is sent an ACK message. The detection of any error 
results in the transmission of an ERROR message to the host. 

&k££X — I£ a calling program read operation is active, the host 
is sent an ACK message. If no read operation is active, the upper 
level program is shown the occur a nee of the ALERT with an 
unsolicited message. 

£2&£ conyersfroqs gpr 20QUT emulator, 

The 2000T emulator operates internally in ASCII mode. All 
buffers transferred between the driver and the caller are in 
ASCII. The central system may use ttCD (internal or external) or 
ASCII). The former requires code conversions be done on received 
and transmitted data. 

Received data (INTERNAL or EXTERNAL BCD) is translated via 
translate tables (INTAS, EXTAS) to ASCII. 

Transmitted data is translated from ASCII via translate 
tables (ASINT, ASEXT) to Internal or External BCD. 

In addition, conversion of inbound codes following an escape 
code are converted to ASCII using tables IASES and EASES if a non- 
ASCII code is in use. 
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III. Design Structures 

M a -for Function ary On ^t s 

CLEAR 

Description 

Puts the I/O board in "on hook" condition (drops data terminal 
ready) • Clears all status word's except "extended status". 

JSB .IOC. 

OCT 000QXX where X;, id logic*; u;*it number 

No rejacts are possible. 

1. Turn off data terminal ready. 

2. Clear the driver and resst to idl* .state. 

3. Clear status word in EQT. 

4. Disable I/O interface. 

NOTE: CLEAR is issued to terminate all activity on the 
communication link. The CLEAR should only b>? issued aftej^ all 
operations are complete (no outstanding reads or writes). ^* 
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Read a block of data from the host system. Execute error 
detection on the incoming data block. 

The following conditions will result in an error message being 
sent to the host system. 

1. Nonexistent Station 

2. Station address of 1i0 or 160 in any n« a .ia^ other than 
POLL. 

3. Unrecognized message control code. 

4. No E code or erroneous E code in message. 

5. Word parity error (in auy character). 

6. Message parity error. 

7. Carrier dropped before EOT cr LRC character received. 
IHterJace_S£eciii £ atjcn 

JSB .IOC. 

OCT 0100XX where XX is logical unit number 

Beject Address 

Buffer Address 

Buffer Length (positive bytes) 

The call may be rejected for the rollowing reasons: 

1. Terminal "off-line" (E value not complete) 

2. Driver is busy. 



Notes: 



a) The transmission log will reflect the number of 
characters received. 

b) The transmission log includes the control code after 
the site address through the ETX character. 

c) A buffer overrun will be treated as a carrier loss 
error. 
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d) If an operation ether than WHITE or ALERT is received 
from the host, the read operation is terminated with a 
status of 1 in the D50CD E^T. This indicates that: the 
read operation is inappropriate for host activity and 
allows the caller to alter its I/O operations.. Thus, 
when no other I/O can be scheduled, a read operation is 
always safe* 

Algorithm Descr j-,ptiog 

1. Await a host POLL operation. 

2. Receive and buffet th* data trom the t.ost, generating 
message parity ^ a per ch-tracter nasi-?. 

3. Check LRC on receiving message parity character,* If 
there is a parity error or any other error mentioned 
above, send an error message to the host. 

Read is the operation issued in response to a host system WRITE 
message or ALERT message. 
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gQSc,Ei T etiqn_,ftnd i .FijT}c&49P 

Sends a block of data to the host system. 

J SB .IOC. 

OCT 02G0XX where XX is the logical unlt x nunber 

Reject Address ^ 

Address of Buffer 

Length of Buffer 

The call nay be rejec d for the toilowing reasons: 

1. Terminal "off-line" 

2. Driver busy 

NOTE: The caller must supply only data in the buffer through the 
associated "E" code. The driver will supply th'= message prefix 
and trailing ETX coda. 
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HRJTE^READ 

Descr iption .. g tnd Function 

As the WRITE operation except the writs buffer is used for a read 
operation at the termination of the WRITE. 

Interface Description 

JSB .IOC. 

CCT 021 OXX where XX if the logical unit number 

Reject address 

write Butfer address 

Length of write buffer 

The call may be rejected because the driver is busy or the 
terminal is "off-line". The read length is always assumed to be 
1040 characters. The read buffer is the. same as the write buffer,. 
Therefore, any incoming data overlays- the original write data. 

Algorithm Description 

The write will send data to the host in response to a POLL from 
the host. After all data is sent a read is performed. The read 
accepts data from an incoming host WRITE message. 

NOTE: The driver does not support write diagnostic operations. 
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ENABLE 

pescyi ptio n an d M function 

Establishes the communication line for the terminal. Allows 
either manual connections or auto answer connection. 

JSB .IOC. 

OCT 022QXX where XX is the* logical unit number 

Reject address 

Buffer address 

Buffer length 

M!£sr: 

Word #1: BIT 0=1 Operate in ASCII mod'? 

BIT 1=1 Operate in Internal BCD mode 

BIT 2 = 1 Operate in External BCD mode 

BIT 8-15 SITE ADDRESS 

The call can be rejected for the following reasons: 

1. The "terminal is already "on-line". 

2. The driver is busy. 

A/l.gor^£hg t ,.D.escr,i r pt3 P on 

1. Prime the I/O board. 

2. Wait for carrier from modem. 

3* Enable host receive operations. 
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Description an d u guflgtAon. 

The use of this call is to pass statistics on the interface's 
performance during a terminal session. 

JSB .IOC. 

OCT 0120XX vhere XX is the -logical unit number 

Reject address 

Buffer address 

EEC 6 

After this call statistics are kept in thf. buffer addressed by the 
vord in tha calling parameter list. 

The call should be made before the ENABLE call is issued. The 
caller will never be rejected. 

1. The following statistics are maintained in the storage 
addressed by the reguestor: 

^ARD 1 erroneous station addresses 

WORD. 2 erroneous control cod^s 

WORD 3 character parity errors 

WORD 4 message parity errors 

WORD 5 carrier losses 

WORD 6 missing write control codes 

WORD 7 code indicating type of line drop 

(0=clear reguest, 1=loss of data set 
ready condition, 2=failure to receive 
any data from host for 2 minute period) 

(see the project ERS for amplification) • 

Notes: Whenever a call to D50CD is rejected the following return 
codes will appear in the "A" and "B" registers: 

A B Reason tor Reject 

Illegal request 
Terminal is offline 
Driver is busy 



1 





1 


1 


1 


100000 
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Unsolic ite d Events 

The following unsolicited events are defined for D50CD. 



ALERT received 
WHITE received 

LINE DROP OCCURED 



A=logical unit number 
B=000001 

A=logical unit number 
B*000002 (also, bits 15:8 
contain the write message 
"E" code) 

A^loyical unit number 
B-G00000 



In the case of an unsolicited write operation the driver will 
reject writes (station busy) unfil a read operation is issued. 

The driver is completely responsible for line quality monitoring. 
The monitoring is accomplished by the alternating station 
addresses in messages received from the host, 

*** 

All data passed to C50CO is assumed to be ASCII. All data passed 
to the caller is also ASCII* Code conversions are done by 050CD 
from/to ASCII and INT/EXT BCD. 

Summary of 050CD IOC calls 



FUNCTION 


5UBFUJJCT.J0N 


2 PEJ ATIO N 


3ETJJRN 


00 


00 


Wpiri £9 A&t 


Immediate 


01 


00 


BEAD 


Asynchronous 


01 


20 


EXTENDED STATUS 


Immediate 


02 


00 


WHITE 


Asynchronous 


02 


10 


WHITE/RE AC 


Asynchronous 


02 


20 


ENABLE 


Asynchronous 
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SECTION VI 
PROBLEM ISOLATION 



PRUBLF.M ISOLATION 



Unfortunately* there is no one way of localizing any prob- 
lems which miqht occur in the IOP. However, tracks do exist 
which could help you in localizing the bug or possibly solving 
it. Outlined in the following paragraphs are essentially those 
tracks which you can check to, if nothing else, eliminate certain 
modules as suspects. 

1) Looking at the entry point of .GETQ 

This will give you the handler who last got something from 
his work queue. 

2) in addition, entry points of .PUTO, .PRIQ, .FREB and .GETB 
give you the same type of information. 

3) Due to the nature of power fail recovery, the I. XX entry 
points of all drivers will be cleared. Hence, if a HLT 2 
should occur and the I. XX entry point of a driver is non- 
zero, then he was the last one in control and most likely the 
cause of the problem. 

There Is one exception to this rule. The interconnect kit 
driver D.61 contains the code to process a cold dump request. 
As a result, if a cold dump is taken, the 1.61 entry point 
and some DMA related information get wiped by the dumping 
process. Since this data is recognized as valuable, the 
dumping routine saves it before executing. The information 
can be found within D.61 as follows: 

KSNI. contents ot 1.61 

KSNl.+l DMA routine return address 

KSNX.+2 DMA buffer address 

KSNI. +3 DMA buffer length 

4) There exists a trace table of SP to IUP communications, 
(entry point D.61S in D.61), This will give you the last 50 
ICK transmissions. You cannot conclude that the last thing 
received from the SP was the culprit, remember many things go 
on asynchronously. Its just another source of information on 
whats happening in the system at the time of the crash. 

5) The entry point of .IOC. will show who was the last to cross 
the boungary from system (handler level) to I/O (driver 
level). 

6) QIT entries will show you what's pending on the work queues 
of all the handlers, what is on the work queue can almost be 
eliminated from the cause of the problem by the fact that the 
processing they invoked has not yet taken place. 



6-1 



7) 
H) 

9) 
10) 



The CKU will snow you what 
not yet been processed. 



1/0 events nave completed but have 



ROT entries will yield information about all DRg's: whether 
a device is suspended, whether the last event for that device 
comnleted, and finally, the hardware status. 

QTOP in D.43 points to those events which are oeing timed. 

Buffer oendina queues will snow if. there is a bottleneck in 
the returning of ouffers. If the count for each handler 
becomes laroe, then someone is hoqging the buffers and not 
returning them. This "hoaginq" should never occur. 

11) Tne m*in trace table traces comoleted events (both solicited 
and unsolicited) and all calls to ,PH1Q and .PUTQ. This 
table has room for fifty entries (100 words). The trace 
routine is found in tne module MN. TTPTR will oe pointing to 
the next slot in which an event will be traced. The previous 
slot will contain the last event put on the trace table. 
Events are traced as follows: 



a) .PUTO/.PH10: A reg - 

B req - 

b) Completed events: 

solicited - A req - 

h reg - 

unsolicited - A req - 

r* req - 

NHTKS: 

a) .PUTU and .PR1U call 
after they are called 
mane when the PUTO/PR 
calls tne trace routi 
COMPLT processor is j 
an IOC int.errddate re 
for some handler to p 
entry is made after t 
driver level and afte 
the Cm.), but immediat 
the related handler i 



address of 
address of 



OIT to receive buffer 
the buffer 



oriqinal I/O call parameter 
address of the butter 
function plus unit reference 
event data driver generated 



the trace routine immediately 
This means the trace entry is 
TO happens. The CurtPLT processor 
ne to trace completed I/n. The 
umped to from the commutator when 
auest has revealed completed 1/0 
rocess. This means that tne trace 
he event nas completed at the 
r the event has been removea from 
ely before the HC entry point of 
s called. 
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b) Decoding the main trace table sometimes appears a fine 
art to the uniniitiated. Using the following algorithm 
will help, 

t. LOOK ONLY AT THE A REGISTER 

2, Compare the A register contents to the QIT 
addresses. If the A register points to the 
beginning of a QIT entry, this is a .PUTQ/.PRIQ 
to the handler represented by that QIT entry. 

3. If it is not a .PUTQ/.PRIQ, then it should be a 
completed I/O event. The last six bits of the 

A register give you the IOC unit reference number 
for the device. The Eguipment Table (EQT) is in 
unit reference number order (first entry is unit 
reference # 7). Use the unit reference * to index 
into the EQT and find the select code of the 
device. This will usually tell you what device it 
is. If you don't Know the configuration, go to 
the Device Table. It contains both the select 
code and designator for each device configured 
in the IOP. Now that you Jcnow the device, go 
to the documentation for the driver of same and 
find out what Kind of IOC requests/unsolicited 
events it handles. 

Some IOC requests will be obvious. Bit 15 tells 
if it is a queued request or not. Bits 14-12 
give the function. The most common functions 
are read (1) and write (2).. Some examples are: 

010010 non-queued read request - unit ref # 7 

020011 non-queued write request - unit ref # 11 

020210 non-queued write request - unit ref # 10 

012011 non-queued read request - unit ref * 11 

110015 queued read request - unit ref # 15 

120015 queued write request - unit ret # 15 

If it's not some type of read or write, it's most 
likely an unsolicited event. The B register 
contains the relevant unsolicited event data. See 
the documentation on the driver presenting the 
unsolicited event to decode the event da'ta. 

12) The interrupt trace table is another trace of past IOP 

activity . .TINT (found in module MN) is called from every 
I. XX entry point. The address of the I. XX entry point and 
the contents of that location (ie. what module got interrupt- 
ed) are recorded. The interrupt trace table has room for 50 
entries (100 words). TIPTR will be pointing to the next slot 
in which an enterrupt will be traced. The previous slot will 
be the last interruDt that occured. 
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13) A list of addresses and other paramaters is generated by IOPC 
and loaded into the IUP at configuration time. The address 
of this list is moved to location 3 of the IOP at system 
start-un. If any IOP module detects a serious problem, a 
system DEATH routine is called which saves the environment in 
this same list, Similarly, if the operator executes the IOP 
PANIC loop and the environment has not already been .saved, it 
is saved as above. This list exists primarily for the cold 
dump analyzer's use; hut is very helpful if no analyzer is 
available. 

COLD DUMP ANAIiYZKR LIST 



WORD. 



CONTENTS 



b 

7 

H 

9 

10 

11 

12 

13 

14 

lb 

lb 

17 

18 

19 

20 

21 

22 

2 3 

24 

2S 

26 

2 7 



IOP date code 
A register 
B register 
Flaas - bit 2 
bit 1 
bit 
F register 
p register 
= 
# 



= int sys status 
= E register 
= o register 
(register save stack pointer) 



info saved when PAN 
info saved when DKA 

and this is addres 

it waff called 

of device a 



DF.F .DAT address 
OFF .DVTH address of oevice t 
DFF iyiTAi) address of yir's 
DF.F PULPT addrsss ot SCOL lis 
DFF Q10P address of D.43 TOE 
DEF LUT51 address of D.51 uni 
DFF I.UTM address of D.61 uni 
DFF UCTOO address of D.63 uni 
DFF SIIMK address of ICKH uni 
DFF SI RAF address ot ASFH uni 
DEF D.bis address of D.61 tra 
DF.F TTPTR address of main tra 
DF.F CPO address of .IOC. CR 
DFF OHEAD address of .IOC. fr 
DFF STST address of SYNdH/C 
DF.F PNTR address of MEMRY tr 
DEF EOT address of equipmen 
Copy of lOPC's .MOPT word 

Address ot first buffer in pool 1 

Address of last bufer in pool 1 

Address of first buffer in pool 2 

Aadress ot last buffer in pool 2 



IC executed 
TH executed 
s from which 

ssignment taol 
able 



chain head 
t tables 

tables 

tables 

tables 

tables 
ce pointer 
ce pointer 
head 
ee storage 
D) tables 
ee list 
t table 
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If a cold dump analyzer is available, it will use the above 
list to print out almost all the tables and traces in the IOP 
in a neatly formatted listing. The interrupt trace table is 
not broken out by the analyzer. The other two trace tables 
are, with the most recent event printed at the top of the 
table. 



G$A C0U> DtX\AA.P AWM^Jfc-E* 



^ 
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SECTION VII 
IOPC 



I. Product Identification 

IZ& ££2cesso£ Configurator SJQRCl 

The purpose of this prograa is to configure I/O Processor 
(IOP) programs for the HP20C0 ACCESS systems* Since the IOP 
program can contain various components and features, a technique 
is required to selectively lead and merge needed modules to make 
up the IOP system desired by the user. Some of the possible 
features vhich may be configured are: number of TSB ports, IOP 
memory size, 2741 support, ASCII files support (line printers, 
card readers, tape punches, etc.), and RJE access to various host 
systems. 

A secondary purpose of IOPC is to perform loading (reloading) 
of the IOP, 

II. Design Overview 

J&si££ assua£tjgns 

IOPC is not-a stand alcne program, although it is written in 
absolute form. It is one of several programs which are used to 
configure complete HP2 000 ACCESS systems (the others being the 
7900 loader, 2883 loader, etc.). The MCP or Master Configurator 
Program controls the loading and invocation of the various 
configuration routines. The MCP contains I/O drivers for the 
system console and magnetic tape units. IOPC utilizes these 
drivers and several other parameters and subroutines in the MCP. 
One special capability of the MCP is the application of "patches" 
or "fixes" to the program binarys which it reads. While this is 
transparent to IOPC, it does allow the application of such patches 
to the IOP program which IOPC creates. 

The entire HP2000 ACCESS system is distributed on a master 
magnetic tape. File one of the tape is the MCP. A small 
bootstrap program is used to lead and initiate the MCP. The MCP 
then can load IOPC. Each master tape file after the first (MCP) 
is identified by a file id record. within the file, groups of 
binary records are identified by group id records. The entire 
file is terminated by a file end id record. The purpose of these 
id records is to allow MCP tc identify files for tape positioning 
and to identify binary records for the application of patches. 
IOPC is only concerned with the file id records for the files 
which it uses. One file is the standard modules file. The second 
is the optional modules file. Third is the IOP core image file. 
A complete outline of the files and file id records assumed by 
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IOPC may be found in Table 1. Further details on the use of these 
files will follow. 

Other design assumptions for IOPC are: 

1. Select code 11 is assumed to be the transmit channel 
interconnect kit interface to the IOP. 

2. Select code 1 2 is assumed to be the system console. 
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ID £e£0.£ds - An ID record is exactly 5 words long and has the 
following form: 

15 14-12 11-9 e-6 5-3 2-0 

r - ^ 






I 


I -1. I | 





I o 





I 


| 2 | | 





i 1. 


(id nuaber) 


P 


i 


(info, wcrd) 










(checksum) 







Tha ID number is an unsigned 16 bit positive integer (0<n<65535). 
File ID numbers must be a multiple of 1000. The information vord 
does not apply to ID records appearing on the master tape* This 
word is used on patch tapes only (see MCP). The "F* bit 
designates a relocatable (set) or absolute (clear) group of binary 
records. An ID record can be assembled as follows: 

OBG 2001 E 

ABS IDVAL 

DEC 

BSS 1 



H&S&SJ. £l£§ orqa.n^zatjron - 
master tape had the following 



At the time of this 
file organization: 



document, the 



£U& Co&te.££s £il3-M 

1 MCP none 

2 IOPC 1000 

3 Std. IOP modules 2000 

4 Opt. IOP modules 3000 

5 7900 Loader 10000 

6 2883 Loader 11000 

7 7905 Loader 12000 

8 TSB System 20000 

9 IOP copy file 65000 



format 

absolute 

absol ute 

relocatable 

relocatable 

absolute 

absol ute 

absolute 

absol ute 

absolute 



I2££ i ilftg " At the tim€ of this document, the master tape 
organization of IOPC related files was: 



1000 



<iro]i£_ID 
1010-? 



Contents 
IOPC program 
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2000 



3000 



2C10 


HN 


2020 


DUMP 


2030 


TB6H 


2040 


ICKH 


2050 


NOXH 


2060 


HEHRY 


2070 


IOC 


2080 


D43 


2090 


D61 


3010 


D51B 


3020 


D51A 


3030 


D63 


3040 


D62 


3050 


050IB 


3060 


D50CD 


3070 


D110 


3080 


D120 


3090 


D130 


3100 


D140 


3110 


D340 


3120 


D11C 


3130 


D12C 


3140 


D13C 


3150 


D14C 


3160 


D34C 


3 170 


• 2741 


3180 


.274E 


3190 


.274C 


3200 


MNRIB 


3210 


NNBCD 


3220 


HCSL 


3230 


004 


3240 


ASFH 


3 250 


SYNIB 


3260 


SYRCD 


3270 


CIO 


3280 


CICIB 


3 290 


CICCD 


3300 


CCDIB 


3310 


COD CD 


3320 


CCOIB 


3330 


CCOCD 


3340 


PDOIB 


3350 


PCOCD 


3360 


PPO 


3370 


CBO 


3 380 


PRO 


3390 


RPO 
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3400 


LPO 


3410 


PUOIB 


3420 


CGCIB 


3430 


CCCCD 


3440 


PDCIB 


3450 


PDCCD 


3460 


CEC 


3470 


LPC 


3480 


PPC 


3490 


RPC 



I2££ ass umpt ions - The order of the binary groups in the standard 
and optional nodules files (IDs 2000 and 300 0) is not random. 
Modules in the standard modules file are always loaded by IOPC. 
This is true even if the module can not be identified by IOPC (see 
• NAMT). Further, it is required that the first module in the 
standard modules file be the MN or managers module* This is to 
insure its loading at location 2000 which, in turn, assures the 
documented start addresses for PANIC (2000) and the IOP to IOPC 
unloader (2002). 

Not all needed modules are in the standard modules file. 
Even a minimum system requires loading of the appropriate D.51 
module and 0.04 module from the optional modules file. Generally, 
the modules in the optional modules file are ones which are 
variant in some way. Some details about this file are: 

1. D.04 must follow a^l driver modules. 

2. Variant RJE modules are assumed to have names (NAM 
records) with the last two characters indicating the 
version (e.g. IB for IBM, CD for CDC, etc.) 
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££sic[n a ppr oac h 

IOPC has three distinct processing sections. First is the 
system configuration dialogue* During this section all guestions 
about configuration are asked. The operator's responses are 
analyzed. The outcome is the establishment of various 
configuration parameters and control blocks which vill determine 
further processing. 

The second section of IOPC is essentially a relocating 
loader, nodules are selected from the master tape as reguired. 
These are relocated and linked together to create the IOP program. 
In addition,, a number of binary module modification processes are 
also involved. The purpose of these processes is to contract 
needed IOP control blocks, buffers, etc. Also, such things as the 
merging of select codes into I/O instructions can be done. A 
final function of section tvc is to create an optional ccpy of the 
configured IOP program. 

Section three of IOPC produces a memory map and report of the 
configured IOP program. 

III. Design Stucture 

5llS structures 

Several control blocks and parameter lists are used during 
the configuration process. These are outlined here. 

fiastej: configuration, lab^e l**2Xil 

This table, located en base page, contains most of the 
configuration parameters. While it does contain some default 
values, most of this table is filled in as a result of operator 
specifications during the system configuration dialogue section. 

•BSEiiJs) I&JLS S2I&SJ& 

highest memory address in IOP 
zero relative number of ports (default is 31) 
TTY buffer size for each port in words 
(default is 60) 
34 . MOPT optiors flags: 

Bit neanins 

15 2741 EBCD code 

14 2741 CALL 360 code 

12 IBM RJE 
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9 


.HE US 


1 


.HPN 


2-33 


.HPBS 



35 


• HSCM 


36 


. MHRD 


37-43 


.— — 


44 


• HHLD 


45-51 




52 


.MHPD 


53-59 


..«•• 


60 


,HACR 


61 


• Ml LP 


62 


• HAPtJ 


63 


.HARP 


64 


• MA PR 


65 


• MCHT 


66 


• JT# 


67 


• JL# 


68 


. JP# 


69 


• HA FN 


70-7 


• HASF 



11 CDC RJE 

1 create master tape IOP copy 

create separate tape IOP copy 

highest used select code in IOP 
number of host readers (default is 1) 
device assignments for host readers 
number of host line printers (default is 1) 
device assignments for host line printers 
nuaber of host punches (default is 0) 
device assignments for host punches 
number of card readers 
number of line printers 
number of tape punches 
number of reader/punch/interpreter 
number of photo-readers 
number of I0P> modulas to be loaded 
number of job transmitters 
number cf job transmitters 
number of job transmitters 
negative number of ASCII files 
3-word ASCII file apecif ications: 
H°Jl£ Co ntent 

device designator 

1 15:12 characteristics 

7:6 subtype 
5:0 select code 

2 record size in words 

lemorx Jllgcatign £able 

This table keeps track cf IOP memory as it is allocated. 

J2P.I& Ha-me Conijjjt 

holds address of 1st word of base page links 

holds address of 1st word of available 

bass page 

holds address of last word of available 

basd page 

holds address of 1st word of available 

program memory 

holds address of last word of available 

program memory 

A^CII Files Dialogue Control Table ( t AC T.) 

This table controls the system configuration dialogue for 
ASCII files. It also provides basic parameters for the 
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1 


FWBP 
FWABP 


2 


LWABP 


3 


FHAM 


4 


LHAM 



establishment of the .HASP entries which are generated from the 
ASCII files dialogue* Each eight word entry in .ACT. is as 
follows: 

2.QR& C onten ts 

Device type name (2 ASCII characters) 

1 Basic device designator 

2 Minimum number of this device allowed 

3 Maximum numfcer of this device allowed 

4 Default reccrd size in words or a negative value 

5 Maximum reccrd size or address of device subtype 
table if word 4 is negative (see note below) 

6 Device characteristics and flags: 
Bit 15 ■ 1 if input device 

Bit 14 * 1 if output device 

Bit 12 » 1 if only output allowed is CTL. 

Bit 7 « 1 if BJE pseudo device (causes this 

entry to be bypassed in no RJE. Also prevents 

request for select code.) 

Bit 6 ■ '1 if SP device 

Bits 5-0 contain select code for SP devices and 

number of associated select codes if IOP device. 

7 Address of list of addresses of words to receive 
number of these devices to be configured (list 
is terminated by minus one value) 

8 Address of word to receive address of first •HASP 
entry corresponding to this type of device 

Note: for devices which come in several flavors, word 5 addresses 
a subtype table. This is indicated by a negative word 4. In this 
case, word 4 represents the maximum subtype expressed negatively. 
All subtypes are zero relative. A subtype table is as fellows: 

E2£3 Contents 

Default (and maximum) record size for subtype 

1 Same for subtype 1 

2 Etc. 

New types of ASCII files can be included by simply adding new 
entries to this table. A negative one word terminates the table. 
The order of the table must be as follows: all system processor 
devices, all RJE pseudo devices, all IOP devices. 

Ho&Ul« Lo adinS Table f.NAHT ) 

This table contains all information required to make 
load/noload decisions about modules encountered in the binary 
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input files. In addition, other inforaation is present to be used 
in configuring various tables (EQTs, etc.). The order of . NAMT 
entries for drivers and handlers indicates relative IOC and TSB 
logical unit numbers which oust be derived from this order and 
ether information such as that in .MCT. Entries in . NAMT for 
standard file modules must contain a copy count of 1. Other copy 
counts are established during the initial dialogue. The format of 
.NAMT is as follows: 

£2£&i&L Contents 
0-2 nodule name 

3 Module characteristics: 

Bit = 1 if module is handler 

Bit 1 = 1 if mcdule is driver 

Bit 2 = 1 if module is varying RJE module 

Bit 3 = 1 if module is RJE module 

Bit 4 = 1 if module is ASCII file module 

For handlers: 

Bit 15 ■ 1 if module has prime entry point 

Bit 14 » 1 if module has I/O complete entry point 

Bit 13 = 1 if module^fras initialization entry point 

Bit 12-1 if module rapresents allocatable resource 

For drivers: 

Bits 15-14 are EQT characteristics 

4 Number of copies to load 

5 Designator case (if handler) 
Driver number in bits 7:0 and number 

of associated select codes in bits 15:8 
(if driver) 

6 DBL exit address 

7 ENT exit address 

8 END exit address 

9 Module index number (for use as index to special 
processing routines) 

10 For handlers, this word contains the logical unit 
number associated with same. If multiple copies 
of the module are loaded, this will be the first 
of the assigned unit numbers. For drivers, the 
basic select code of the module is contained 
here. For drivers which are loaded multiple 
times for use as ASCII files, this word contains 
the address of the first .MASF entry which 
corresponds. For several basic modules, this 
word initially contains the number of associated 
select codas. 

The order of entries in .NAMT is as follows: all drivers, all 
handlers, all ether modules. The drivers and handlers sections 
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are in relative logical unit number order both for IOC and TSB 
logical unit numbers. A negative one value delimits the table* 

Pseudo Base Page 

One memory page of IOEC is reseved for use as a pseudo base 
page. On this page is contructed the base page which is 
eventually loaded into the ICP. Some locations are assembled into 
this page which are assumed by the IOP program. These are: 

L ocatio n C ontent 

2 "" JMP 3,1 for system start 

5 HLT 5 fcr memory failure 

6 CLC 6 for DMA channel 6 

7 CLC 7 for DMA channel 7 

Location 3 is later filled ty IOPC with the last (hopefully only) 
transfer address encountered in the processed binarys. Location 4 
is configured by the D.04 module modification appendages. 
Locations 10 through 77 ar? initially zero to indicate that none 
of the select codes have yet been allocated. They are set non- 
zero as they are allocated during the system dialogue processing. 

Each 5 word entry in this table saves the name and beginning 
and ending addresses of each module loaded into the IOP: 

H.9JL2JS1 Content 

0-2 Module name 

3 Module starting address 

4 Module ending address 

Ihe table is terminated by a word containing a -1 value. 

Ento £oin£ li^t 

Each .5 word entry in this list contains the name of an IOP 
program entry point plus its entry point address and base page 
link address. This list is kept in a reverse order from high 
memory downward: 

4 1st wcrd of name 

3 2nd wcrd of name 
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2 3rd wcrd cf name 

1 address cf entry point 

address of base page link 

In addition, a count of all such entries is kept in variable LST. 
The LSTP routine described below, will establish five indirect 
pointers to a given entry wi.th LST1 addressing word 4, LST2 
addressing word 3, etc. 

£ u .£££i2Jl&l specifi catio ns 

gabjgovjt4ses 

Before discussing the actual dialogue process, several 
subroutines will be outlined. All are used by section 1. The 
READ routine is used as a central console read subroutine. In 
addition to requesting a console read via the MCP console driver, 
a line feed is output to acknowledge the input. Also, the first 
input character is tested for ccntrol-G (BELL) • The occurrance of 
this code is the operator's abort signal. READ then issues an 
abort message and terminates IOPC. Normally, however, READ simply 
returns to the caller. 

The LDBYT subroutine extracts characters frcm the console 
Input buffer and inserts then into the A register. The high order 
8 bits of A are not disturbed. LDBYT advances the buffer pointer 
as characters are extracted. If a carriage return is detected, a 
space character is returned and a W +0 W return is made. Normally, 
return is to "♦1 , », 

A YESNO subroutine processes responses intended to be yes or 
no. The caller provides the address of the question which YESNO 
outputs. Next, the response is read and the first character is 
input. A NO response ( M N M or null input) causes a W +0 M return. A 
yes response ( M Y M ) .causes a " + 1" return. Any other response 
causes the question to be asked again. 

SCREA is a select code input and analysis subroutine. Input 
is a value in A which represents tha number of total select codes 
associated with the basic select code to be input. The B register 
inputs the address of a message part which describes the desired 
select code. SCREA first outputs the select code question. Then 
the OCTIN routine (see below) analyzes the input. Any error 
results in an appropriate diagnostic and reasking of the question. 
Correct octal input is validated as a legal select code. If 
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valid, the given code plus all associated codes are checked for 
previous specification* This prevents overlap. As SCR.EA 
allocates the select codes, it narks their allocation in 
corresponding locations on pseudo base page. Before returning, 
the select code is checked against, . HSCH (maximum select codeji , 
and . HSCM is updated if necessary. 

DECIN and OCTIN process nuneric input and return an internal 
binary value plus an indication of the terminator of the numeric 
string. Both use a cemmen routine but set up a different 
conversion radix. 

IOPCH is the entry point which receives control from HCP (via 
the IOPC entry point),. IOPC is identified to the operator, and 
the optional reload guest ion is asked. A yes answer leads to the 
reload routine described in appendix B. Noraally, a series of 
configuration questions is asked. Processing of these is as 
follows. Note that in many cases, the outcome of the processing 
is to set • HCT. values. Other important details include the 
setting of copy counts and names in the module loading table. 
These settings will determine the eventual nodule selection. 

DATE? 

Any input, except null input, is accepted and moved to the header 
message which is part of the ouput of section 3 processing. 

MEMORY SIZE? 

Decimal input is accepted and compared to a list of valid 
specifications. The corresponding actual high memory address is 
established in .MEMS. 

NUMBER OF PORTS? 

Tha decimal number of ports is input and validated. Depending on 
the specification, the required version of the multiplexer driver 
is selected (A or B) • This is done by setting the appropriate 
name in the module loading table. Also, the associated number of 
select codes is set at either 3 or 6. 

BUFFER SIZE OPTION? 

A no answer to this question results in no further processing, and 
the .HCT. default TTY buffer sizes are used. A yes answer allows 
input of alternate sizes. Any of the three formats of buffer size 
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specification are input and analyzed repetitively until an •END 1 
is input. Each specification is validated, and a range of ports 
is found (may be one port). The given size is then set in the 
corresponding slots of the . MCT. table's .MPBS entries. 

XXX SELECT CODE? 

SCREA is used to input each of the select codes for the tine base 
generator, interconnect kit and multiplexer. The module loading 
table for the associated drivers initially contains the number of 
associated select codes (at offset .NAUN). This value is input to 
SCREA and is then overlaid by the select code returned from SCREA. 

2741 TYPE TERMINALS? 

A yes answer causes the espy count to be set to one in the module 
loading table entry for tha 2741 module. At least one 2741 code 
must then be selected also. These questions are asked and the 
code module copy counts are also set as required. 

INCLUDE RJE FUNCTION? 

A no response causes this section to be skipped. A yes response 
leades to two other questions asking which version of RJE is to be 
included. Next a scan of the module leading table occurs* All 
RJE related modules receive a copy count of one. In addition, 
those which are variant (IBM vs. CDC) have the module names 
modified to raflect the appropriate' required version. Then the 
SCREA routine is invoked to cbtain the synchronous modem interface 
select code. For the IBM version only, the number of each type of 
host function is input. these values are stored in respective 
«$CT. cells (.HHRD, .MHLD, and .MHPD) and in respective .ACT. 
cells for specification of the maximum number of JT , JL and JP 
ASCII file types. Finally, the copy counts for HR, HI, and HP 
modules are set since .these may be loaded in multiple. Next the 
ASCII files question is skipped since RJE requires ASCII files. 

NON-SHAREABLE DEVICES? 

For the yes answer to this question, all processing is controlled 
by the .ACT. table. For each .ACT. entry, the following is done: 

1. If no RJE component is to be included and the file type 
is RJE related, then the .ACT. entry is skipped. 

.2. If only one possible quantity of the file type can be 
specified, then the quantity question is skipped. 
Otherwise it is asked. 
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3. The specified number is checked against maximum and 
minimum* If acceptable, the module loading table 
entries which are related receive appropriate copy 
counts. The total number of ASCII files is updated 
(.HAFN) • 

4. For each file of the type requested, the following is 
done: 

a. A .MASF *ntry is started with the correct device 
designator. 

b. Device characteristics from the .ACT. entry are 
moved to the .HASP entry* (This includes select 
code for SP devices.) 

c*. For real IOP devices, the select code is input 
and added to the .HASP entry* 

d. If a subtype is indicated by the .ACT. entry, it 
is obtained and merged into the .MASF entry* 

e. Finally, the record size is input and added to 
the entry* ' 

At the end of this processing, common ASCII file modules are set 
with appropriate copy courts (unless only SP devices are 
requested). An important fact about the above processing is that 
it results in the generation of .HASP entries in an crdei opposite 
that required for the IOF device table (.DVTB). This was only 
done as a matter of convenience here. However, it forces back to 
front processing of the table during later sections. 

XX DEFAULT DEVICE ASSIGNMENT? 

This question is processed only if RJE is included* First, 
validity checks of the number of ASCII files to the number of host 
functions is done* This is to insure that not more host functions 
axist than devices to be potentially associated with them* Next, 
the question is asked for each defined host function* The 
response is validated as a legal file type for association with 
the type of host function* If valid, a designator is contructed 
and stored in the appropriate .MHRD, .HHLD. , or .MHPD entry. 
These are later used to construct the IOP .DAT table. 

MAGNETIC TAPE COPY? 

The correct IOP copy option is set in .MOPT. 

Several final activities are new performed by section 1. 
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1. The select code for D.61 is copied to associated 
drivers 0.62 and B.63. 

2. For all unspecified select codes from 10 up to the 
maximum I0P select code, a HLT instruction is 
configured into the corresponding pseudo base page 
select code location, 

3. The total number of modules to be loaded is calculated 
and saved. 

4. Logical unit, nuubers are calculated and inserted into 
module loading tatle entries. This is done crly for 
function handlers which are to be loaded and which have 
I/O complete entry points, 

5. The first available base page location (.KSCH+1) is 
set, 

6. The standard modules file is selected via the MCE. 

7. The starting of the IOP loader is requested, 

8. The IOP is loaded with zeros. 

9. Section 2 is entered. 



S ect ion £ - Felocat in<j Load 



5J3£l£J2lifi§s 



Several subroutines which are a major part of section 2 
processing are described first. Note that some of these routines 
(e.g. DIAG) are used by secticns 1 and 3, 

LINK is a routine used to allocate base page indirection 
pointers (link words). These link words are required for the 
resolution of cff-page references of locations by memory reference 
instructions and DEFs not on the same page, LINK accepts input in 
register A, If A is zero, then a new base page link is forced to 
be allocated. If A is non-zero, a scan of existing links is made 
to see if one already exists. In any case, register B is used to 
return the address of the required base page link. LINK maintains 
its base page image on the pseudo base page but returned register 
B values are actual base page addresses. An overflow of base page 
results in an abort. 

LSTI and LSTP are routines used to access the entry point 
list. LSTI prepares LSTP for a scan of the list by setting a 
controlling count and an initial set of pointers. Fiv€ pointers 
are used to allow indirect references to" a given list entry. 
These pointers are adjusted by LSTP. LSTP returns M *0 n when the 
list is exhausted. Normal return is at M + 1". 



7-15 



Several terminal error exits are defined for common error 

types. All have entry points of the form LERx. All produce an 

appropriate message and thee abort* Host add special information 
to the message to. re output. 

DIAG is a general console output routine* An inline DBF to 
the message is the only required input. If the DEF is indirect, 
this implies that IOPC is to be terminated and is not really an 
indirect DEF. In this case, DIAG returns to the HCP after 
properly repositioning the taster tape. Messages are preceded by 
a positive count of the number of words in the message. 

PACK, PUNCH, PPPP, and CKSS are routines used to prepare 
absolute load records for transmission to the IOP protected loader 
(see IOPLD) • PACK adds a vcrd to the absolute record and updates 
the checksum. PUNCH completes the checksum using CKSS and then 
calls IOPLD to load the record. PPPP is then called to reset 
pointers for new PACK calls. 

IOPLD accepts input in register B indicating that a record is 
to be loaded into the IOP (B=0) or that the IOP protected loader 
is to be forced to stop (B=-1) • A timout technique is used to 
insure that the IOP loader is running. Failure to receive a 
response from the IOP prior tc the timeout will result in an IOPC 
abort (unless B=-1 input requested this action). Normally, each 8 
bit byte of A is output to the IOP via the interconnect kit (bits 
15:8 first). 

Section 2 o. ve£ vJLew 

Section 2 processing is essentially that of a relocating 
leader like the one used in ECS or MTS systems. However, there 
are additional functions. The overall flow of section 2 is: 

1. Load modules from the standard modules file. 

2. Position to the optional modules file. Select and load 
required optional modules (there are always some). 

3. Construct IOP system tables, control blocks, etc. 

(.DAT, .DVTB, .COH., QIT's, et . al. ) 

4. Create a magnetic tape copy of the IOP program if 
required. 

Several important extensions to the normal type of processing 
performed by a relocating loader are a standard part of steps 1 
and 2 above: 

1. The module loading table is used to select modules to 

be loaded. Unneeded modules are discarded. 
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2. Modules which are to be replicated are copied to an 
IOPC in-core buffer and repetitively processed from 
that area. This is to prevent the need for master tape 
rereading and to allow singular application of patches 
by the MCP. 

3. Select codes and IOC logical unit numbers are merged 
into the relocated modules* 

4. Optionally, module modification appendages can be 
invoked to perform special processing of the relocated 
image of a mcdule being loaded. Also, special 
processing at the end of module loading can be done. 
These appendages are indicated in the module loading 
table entries. Three are defined as follows: 

ENT exit - For each module entry point (except . SCxx or 
. LUxx),~an exit is made. Registers are set as follows: 

A » address of ENT entry as it appears in the ENT 
record 

B = base address of the module being loaded 

The exit routine is expected to return as follows: 

+0 - normal return, retain the entry point 

♦1 - optional return, discard the entry point 

£IL $xit - Following the relocation of each module 

location, the exit is made. This is done prior to 

loading the location into the IOP. Registers are set 
as follows: 

A = relocated value of location 

B « location address 

On return, B is cf nc consequence. However, A is used 
as returned. Thus, the exit may modify the value to be 
loaded. There are no optional returns. 

END exit - Aftar relocation and loading of the module, 
this exit is taken. No register values are provided to 
the exit, and no optional returns may be made. The 
exit has access tc FWAM and an indication of the next 
available location and may use the ENT exit to define 
needed addresses within the loaded module. FSAM can be 
modified up or doun by this exit as required. .. 
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I§.i2£HsLaa loade r 

Processing of both the standard and optional module files is 
sequential. Routine LDRIN reads through the current file and 
performs minor validity checks on each record read. Each record 
is a single relocatable binary record as produced by an assembler* 
NAM, ENT, EXT, DBL, and END records are accepted. Further, it is 
assumed that all ENT and EXT records precede any DBL records. 
(Note that LDRIN can be forced to read frcm an in-cora copy buffer 
for modules vhich are repetitively loaded). 

LDRIN invokes the NAM record processor in all cases. This is 
to allow for the selection decision. Other record type processors 
are also invoked unless the NAM selection process dictates that 
the module is to be skipped. The PLFLG variable (program loading 
flag) is controlled by the NAM processor. 

LDRIN includes END record processing. At END processing, any 
transfer address is set as the IOP program start address on pseudo 
base page. Note that only one such transfer address is assumed. 
Next, the entry point list is scanned, and the sixth byte of all 
names is set to zero. Originally this is an external ordinal 
which is used in each binary module to associate the "nth" EXT 
definition with any given external reference in a memory reference 
instruction or DEF. Next, the end appendage for the module is 
invoked. Following this, the module map table is updated for the 
end address of the module. The total module count is then 
adjusted. If more modules are to be loaded, LDRIN continues. 
Otherwise, control is passed to section 2 table construction 
processing. 

LDRIN will position to the optional modules file for further 
module selection at the end cf the standard modules file. 

HAfl process 4 pg 

The main purpose of NAM processing is to make a lcad/noload 
decision about the current mcdule. Note that all module selection 
is based on NAM records. Other actions include recording the 
module in the module map table, defining the module relocation 
base, and copying the module to an in-core buffer if a repetitive 
load. 

NAMR first tests for an in-progress repetitive lead. If a 
previously selected module is. to be loaded more than ence, the 
copy count is reduced. ihen it reaches zero, the binary is 
finally discarded. Otherwise, the unit number if any is 
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established (see below) . Then the in-core copy is modified to 
give it the appearance of a new modules 

1. The third or fifth character of the module name is 
incremented (third if a handler and fifth if a driver). 
For example, CEO becomes CR1 and D. 110 becomes D« 111 • 

2. All ENT entries having names of the form XXdXX 
(handlers) or XXXXd (drivers), where M d n is a digit, 
have the d increaented. Processing continues at label 
NM 3. 

For new occurrances cf modules, the module modification 
appendages are set to a dummy exit. Then the module loading table 
is scanned for the name in question. If not found but the 
standard modules file is current, the module is force loaded. 
This will allow the inclusion of special routines such as line 
printer core dumps. If not fcund and the optional modules file is 
current, the module is skipped. If the module is located, the 
following is dene: 

1. If the copy count is zero, the module is skipped. 

2. If only one copy is needed, the module unit number is 
set as are its appendages. Processing continues at 
NM3. 

3. If multiple copies are reguired, the module is copied 
to an in-core buffer. Then the module unit number and 
appendages are set. 

At the NM3 label, module loading is set. The module name is 
copied to the module map table. Pointers to the table entry for 
recording module size are set. The program relocation base is set 
and possible memory overflow is checked. Control returns to 
LDHIN. 

Two routines in the NAM processor are of concern. NMBOM is 
used to establish the existerce cf any select code or logical unit 
number which might be associated with the module to be loaded. 
This is used by the DBL processor for merging into I/O 
instructions and parameters. 

CORED- is used to perform in-core reads in place of calls to 
the magnetic tape driver. This is done for replicated modules. 

'NT processing 

All ENT names are first tested for the forms .SCxx or .LUxx. 
Th^se entry points define locations in a module to which the 
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module's unit number (select code or IOC logical unit number) must 
be added. The occurance of such an ENT is discarded frcm further 
processing after calculatirg the address of the location in 
guestion. These addresses are counted and added to a special list 
used by the DBL processor. 

Normal ENT processing is as follows. The ENT exit is taken, 
and on return, the entry point nay be discarded. If kept, the 
prsvious occurrance of the name in the entry point list is 
chacked. If not found, the entry point is added to the list. No 
base page link is generated at this time since no external 
references to it are yet indicated. Thus, the entry point list 
entry word 5 is set to zero. 

If the name is found aid the entry point address (vord 4) is 
non-zero, then the entry point occurred previously. This is a 
duplicate erroneous entry F°int and IOPC is aborted. Otherwise, 
some previous reference to the entry point has occurred. In this 
case, word 4 in the entry point list is completed with the entry 
point address. The associated base page link also receives the 
entry point address. 

The EXT name is first locked up in the entry point list. If 
not present, it is added to the list. The proper external ordinal 
is set. Also, a base page link is defined. This link will be 
used to resolve references tc the external name with indirect 
references via base page. 

An external ordinal is a non-zero value assigned to each 
external symbol defined by an EXT statement. This definition is 
done by an assembler. The assembler then uses this value when 
assembling memory reference instructions and DEFs which reference 
the external. That is, assenbled with the instruction or DBF is 
an indication that the reference is external plus the associated 
external ordinal. 

If the EXT name already exists in the entry point list, only 
the external ordinal is changed in the entry. 

£JBL processing 

Words to be relocated cccur in 5-word groups in DBI records. 
Ihase groups are preceded by a word containing 5 3- bit indicators. 
Each defines the type of relocation to be performed on the 
respective subsequent 5 values: 
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Absolute value ~"~ 

1 Program relocatable 

2 Base page relocatable (unsupported) 

3 Common relocatable (unsupported) 

4 External reference 

5 Memory reference instruction: 

This is a two word entry. 
Word 1 contains the op code 
plus an indicator of the type 
of reference -- 

' - program relocatable 

1 - base page relocatable (unsupported) 

2 - common relocatable (unsupported) 

Herd 2 contains the 15 bit address 
of the referenced location, 

Ihe DBL processor loops en these 5-word groups and performs 
relocation as noted below. linen the relocated value is ready, a 
scan of the unit merging table is done to see if the word requires 
addition of a select code or logical unit number. Next the DBL 
exit is taken. Finally,, the PACK routine is called to add the 
value to the absolute record. PUNCH is called whenever the 
absolute record is filled* 

For type and type 1 relocation, the value in the EBI record 
is simply added to zero or the module relocation base 
respectively. 

For external references, the entry point list is scanned for 
th* corresponding external ordinal, when found, the base page 
link address is merged into the word and the indirect reference 
bit is set. 

For memory reference instructions, the address of the 
referenced location is generated. An on-page references causes 
merging of the page offset bits into the instruction. For off- 
page references, a base page link is generated. It receives the 
address N of the referenced location and an indirect bit if the 
instruction is an indirect reference. The instruction in this 
case is made to indirectly reference the allocated base pace link. 

Specific module modification appendages are outlined belcn. 
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D.61 - The ENT exit is used to locate words which the CBL exit 
will set (RJE indicator, DMA linkage words, and memory size). The 
END exit is used to return storage from unused LUT tables* 

D.63 - The END exit is used to construct the ASCII file unit 
control tables. 

D.51 - The END exit is used to release unused TT¥ tables. 

All replicated handler modules- The ENT exit locates a word which 
tha DBL exit fills with the relative copy number of the loaded 
module. 

D.04 - Ths power fail interrupt linkpage is set on pseudo base 
page. The END exit then constructs the power recovery appendage 
list and count. It is assumed that D.04 is loaded after all 
drivers. 

HUXH * The END exit deletes unused tables. 

ICKH - Onused unit tables are deleted. Then the TTY buffers are 
allocated, constructed and leaded. 

ASFH - The ENT exit locates the file characteristics list. The 
CBL exit saves a copy of these. The END exit overlays the 
characteristics list with constructed file tables 

IOC - The DMAC2 variable is set to permanently allocate channel 7 
to D.61. 

MN - Interconnect kit logical unit number is merged to IOC 
parameter lists in the allocate manager. 

lSi2l£ c pn st£uction 

Many IOP tables and control blocks are built as follows: 

jCOS x , £123, ajid 19 RX 

A pass is made on the handler entries of the module loading 
table. During this pass, the cemmutator is constructed and loaded 
directly into the IOP. ,^The IODT and QI^s are built in SP storage 
for later loading into the ICP. 

The .COM. entry point is defined. An indirect JSB to IOC is 
built for use in building the .COM. CBQ calls. An indirect JMP 
to the CMPLT routine is built, also for use in building CBQ calls. 
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The seven entries of IODT which handle erroneous references to 
units through 6 are built. 

For each handler entry in the module loading table 
corresponding to a loaded module this is done: 

1. The first 3 characters of the module name are saved for 
use in constructing handler entry point names. 

2. If the handler has a prime entry, a commutator gate and 
JSB to the entry point are contructed. The gate 
address is saved for use in building the QIT. 

3. If the handler has an I/O complete entry point, the 
IODT copy is updated. 

4. A QIT is constructed. 

5. Steps 2 through 4 are repeated for replicated modules. 

6. A .COW. CRQ call is built if the handler contains an 
I/O complete entry point. 

Finally a catch-all CRQ call is added to the- .COM. as well as a 
final JMP to . COM. 

The IODT is completed acd'is transferred to the IOP. 

Next, the QI^s are tranferred to the IOP. Several special 
DEFs are also contructed as fellows: 

first QIT 

QITND (follows QITs) 
first allocatable QIT 
max TSB unit number 
ASCII files handler QIT 

§E£Ts, Buffer Pools, and SCO Ls 

Addresses of each of the three BPRTs is saved as each is set 
to zeros and loaded into the IOP. 

Buffer subpools 1 and 2 are constructed. Addresses of the 
first and last buffers in each pool are saved for inclusion in the 
SCOLs. The number of control buffers constructed is either five 
cr 1/2 the number of TSB ports, whichever is greater. Five 
consols buffers ars always bcilt. 

Each SCOL is built using addresses saved from building the 
BPRTs and subpools. 
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QITAD 


DEF 


QITND 


DEF 


QITNR 


DEF 


QITMX 


ABS 


QITAF 


DEF 



Finally, the buffer managers POLPT list is overlayed with 
the three SCOL addresses. 



.DVTB 

The „DVTB entry point is defined and loaded with a DEF * + 1. 
The negative number of ports is loaded followed by the negative 
number of ASCII files* Finally, the .MASF entries are processed 
in reverse order tc yield each 5-word .DVTB entry. 



The »DAT entry point is defined and loaded with a DEF **1. 
then the . WHRD, . MHLD, and • BHPD lists are used to construct the 
•DAT entries. Two -1 values are added to terminate the .DAT. 

i£l£ SUSl I&i£IIiiE£ Linkag es 

A scan of the driver entries in the module loading table is 
done. For each loaded driver, the following is done: 

1. The driver number is converted to ASCII character form 
for use in name lcokup. 

2. The number of related select codes is saved as are the 
driver characteristics (used to build EQT word one). 

3. The related select code is derived and saved. 

4. The number of ECTs is incremented. The EQT is 
constructed in SP storage using saved information. 

5. For each related select code, an interrupt vector value 
is established. It is assumed that I. XX is the first 
interrupt entry point and that J. XX, K.XX, etc. are 
related to suseguent select codes. If a given entry 
point is not defined, a halt is installed in the 
interrupt vector. Note that the related undefined 
entry point is skipped. These vectors are built on the 
pseudo base page as are the related interrupt linkages. 

The XEQT entry point in IOC is now overlaid with the 1st address 
for the EQTs. This address is alsc saved for section 3 report 
generation use. Finally the EQTs are loaded into the IOP. 
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The memory table is overlaid with a copy of the memory 
allocation table and address cf the cold dump analyzer list. 

£2l& P.ajE Analyzer Lis t 

A list of addresses and other parameters is generated and 
loaded into ths IOP. The address of this list is moved to 
location 3 of the IOP by the IOP software at system start. 
Undefined addresses result ic zero values. The content of this 
list is: 



Hor,d contents 

DEF .DAT 

1 DEF .DVTB 

2 DEF QITAD (address of QITs) 

3 DEF PULPT (address of SCOL list) 

4 DEF QTOP (address of D.43 TQE chain head) 

5 DEF L0T51 (address of D. 51 unit tables) 

6 DEF LUT61 (address of D. 61 unit tables) 

7 DEF UCTOO (address of D.63 unit tables) 

8 DEF SIBIK (address of ICKH unit tables) 

9 DEF SIBAF (address of ASFH unit tables) 

10 DEF D.61S (address cf D. 61 trace pointer) 

11 DEF TTPTR (address of MM trace pointer) 

12 DEF CRQ (address of .IOC. CRQ head) 

13 DEF QHEAD (address of .IOC. free storage) 

14 DEF STST (address of SINxx tables) 

15 DEF PNTR (address of MEMPY free list) 

16 DEF EQTs (address of EQT tables) 

17 Copy of .MOPT 

18 Address of 1st buffer in pool 1 

19 Address of last buffer in pool 1 

20 Address of 1st buffer in pool 2 

21 Address of last buffer in pool 2 

£ase £a^e loa^dina 

After al.l table construction, the pseudo base page is loaded 
into actual IOP base page. If any required modules were not 
loaded, a warning message is issued. 
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Ja£e CO£X 

If no tape copy is requested, section 3 is entered. For a master 
tape copy, the presence of a write ring is insured. Then the 
master tape is positioned to the last file of the tape which has 
file ID 65000. This is the optional copy file. 

For a separate tape, the Master tape is unloaded. The 
operator is asked to mount the separate tape. When this is done, 
the presence of a write ring is insured. Next, a loader program 
is written to the tape followed by a file mark. (See Appendix A 
for a description of the leader program) • 

The operator is asked to start the IOP at location 2002. 
This causes a JHP to an unloader program which is part of the IOP 
0.61 driver. The unloader transfers all of the IOP core image 
back to the SP. This data is formatted back into absolute records 
and written to the tape. Finally, the report generator is 
entered. 

S ect ion 3 - Repo rt Generato r 

The report produced ty IOPC is described below. First a 
summary of the sources of th€ data for this report is given. 

IZ2 li nk age list - the pseudo base page select code vectors are 
scanned in order?"" For each cne, a line of output is produced 
(potentially 3 for the interconnect kit, a special case). The 
linkage is shown, and if the select code can be related to an EQT, 
the EQT information is added. 

M53. E&32. link s, mem o r y bounds - the memory allocation table 
provides the data for this output. Also, an estimate of needed 
free storage is made, and a warning is issued if: 

Available storage <100* 100*R«- (HR«- HL+HP) +100*A 

where R-0 if no RJE 
1 if RJE 
Hx*repective host functions 
A-number of ascii files 

It must be pointed out that this estimate is vejy. very rough. It 
attempts to reflect the need for RJE buffers by one-halt of all 
host functions concurrently and all ASCII files concurrently. 
However, the formula assumes a 400 byte communications buffer 
which may be incorrect for some IBM systems and is certainly 
incorrect for CDC host systens. 
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£■§£!! f ile s - a summary of the . MASF entries is produced 

]|0£! Junction assignments - the .MHRD, .MHLD, and • MHPD tables are 
summarized 

module raaj) - The contents of the module map table is listed 

£11 5J1SE1SLI * The in-core copy of the QITs previously built is 
used to calculate QIT addresses and designators* 

l£t£I £2iai list - The ' entry point list, is sorted and then 
printed. 

M£2Il Outline 

The report produced by IOPC supposedly contains sufficient 
information to assist the analyst in resolving program problems. 
It also gives certain information of value to the user. This 
would be information about tfce size of a given configuration as 
well as available and/or unused memory space. Such information 
can be valuable in making decisions about system performance as 
well as upgrades which may fce considered. The report is outlined 
below. 

I/O PROCESSOR MEMORY MAP DATE=8/6/75 

This line of the report is the first line output. It identifies 
the map and also identifies the particular configuration with the 
information supplied by the operator to the DATE? question of the 
initial dialogue sequence. It is not necessary that that 
information be restricted tc a date. In fact, some other 
identification of the systam type might be advisable. 

I/O LINKAGE 
S.C. DRIVER I.L. I.E. O.K. EQT 
A B C D E F 

The I/O linkage list gives a complete summary of the relationship 
of select codes to interrupt entry points, .IOC. logical unit 
numbers, and equipment tables (EQTs) . Each line of the report 
corresponds to a given select code, and the select codas are all 
reported from 10 through the maximum salact code used (.MSCM) • 
Not all of the A, B, C, etc, values will appear in each line. 
This is true in those situations where multiple select cedes are 
associated with a given EQT. The contents of each line are as 
follows: 

A Select code 
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B Name of driver (sane as driver's initiator section 

entry point name). This field of the report may 
contain blanks if the select code is one cf several 
associated with a given driver* The field may also 
contain the word W HLT" if there is no interrupt entry 
point associated tith the select code. In this case, 
the actual location will contain a HLT instruction with 
a halt value corresponding to the select code. 

C Base page address which is object of indirect JSB 

located in select cede vector. The content of this 
base page location is the address of the associated 
interrupt entry point. These locations are 

collectively referred to as interrupt linkages. 

D Interrupt entry point (same as entry point name of 

driver's continuatcr section). 

E ' .IOC. logical unit number. 

F Address of EQT associated with this select code. This 

value and the E value will appear only for the first 
select code (base select code) associated with a given 
EQT. Note that fcr multiple select code devices, the 
IOP program currently assumes that the select codes are 
contiguous. ' 

Th? select code associated kith the interconnect kit is a special 
case any may result in one, two, or three lines in this report. 
This is because in addition to the basic D.61 driver, two other 
drivers may also be loaded irtc the system (D. 62 and D. 63) • 

BASE PAGE LINKS - X- I 

Here are reported the first and last base page addresses used as 
indirect linkages. All other base page locations from Y + 1 to 1777 
are available. 

AVAILABLE MEMORY - X-Y 

Unused memory from location X to location Y is reported. Note 
that this area of memory and any unused base page are the free 
areas available for dynamic buffer allocation. 

ASCII FILES 
L.U. DESIGNATOR SELECT CODE EECORD SIZE 
ABC D 

This report appears only if at least one ASCII file is defined 
into the system. Each line cf the report describes one ASCII file 
as follows: 
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A Logical unit nun 
programs. 

B • ASCII file dev 
subtype indicator 
devices which c 
printers and card 

C The select code 
No select codes a 
Note that- the se 
select codes, 

D Default record 
for use with the 
by the BASIC prog 

HOST DEFADIT 
FUNCTION DEVICE 



ber cf the ASCII file as used by BASIC 

ice designator and possible device 
• Subtypes appear only for those 
cme in several flavors such as line 

readers. 

of the device is given if applicable, 
le associated with RJE pseudo devices. 
lect code for MT and PR devices are SP 

size in words which will be allocated 
device. This value may be ever-ridden 
cannier. 



This report is not produced if no RJE 
system. The report shows the default 
host functions which will be made in 
other words, this report reflects the 
table. 



component is included in the 
assignment of ASCII files to 
a freshly loaded system. In 
initial content of the .DAT 



MODULE MAP 



Each line of 
entry describes 
beginning and 
modification app 
size may not cor 
is the interconn 
discards unused 
memory occupied 
as a part of the 

QIT SUMMARY 



this report 
the name of 
ending ad 
endages adju 
respond to t 
ect kit hand 
tables and t 
by these buf 
interconnac 



nay contain up to three entries. Each 
a loaded module as well as its 
dresses. Note that if any module 
st the image of the loaded module, the 
he assembled module size. One example 
ler. For this module, the END exit 
hen constructs all TTY buffers. These 
fers will be reflected in this report 
t kit handler. 



For each function handler in the IOP program, a QIT control block 
is constructed. This major control block is used to hold work in 
the form of buffers for tha handler. In addition, various handler 
antry points are noted in the QIT. Each QIT contains a name very 
much like the ASCII files device designators. In fact, some names 
correspond directly, while ethers are unique (e.g. the one for the 
interconnect kit handler) . This report gives the designator 
associated with each QIT as well as the QIT address. 
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ENTRY POINT WAP 

Hare are listed all entry points in the system together with their 
antry point location values. If any entry points are discarded by 
ENT -exits, these will not appear. Also, the . SCxx and .LOxx entry 
points will net appear. The list is alphabetized. If an entry 
point is referenced but is never defined, the report will reflect 

this fact by using M * " rather than an entry point location 

value. Certain of these unresolved references are acceptable. An 
example is the reference to the 27U1 modules by D.51. It is, in 
fact, the case the D.51 detects the presence of the 2711 modules 
by observing the resolution cf the reference. 

IV. .Appendices 

The following appendices are attached to this document: 

Appendix A — Separate tape IOP leader description 
Appendix B — Optional IOP reload procedure 
Appendix C — naintainecce guidelines 
Appendix D — Restrictions on relocatable modules 
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jpcendix A 
Separate ta^e IOP loader descriptio n 



When the optional copy of the configured IOP program is 
transcribed to a magnetic tape different from the master tape, a 
special IOP loader program is also written to the tape. This 
loader program is suitable f cr loading by the HP2000 ACCESS 
bootstrap program which is distributed in paper tape form. When 
this loader program has been loaded, it is given control by the 
bootstrap program and proceeds to load the configured IOP program 
into the IOP. The format of a tape written for this purpose by 
IOPC is as follows: 



I II II 

| Loader program | T.M. | Copy of IOP program | T. H. | 

I II II 



L- 



T. M. = Tape nark 

The leader program reads tfce second file and transfers it to the 
IOP protected loader. This is similar to the IOPC optional reload 
process which reads the special master tape IOP copy file and 
transfers it to the IOP protected loader. 

The loader program is initially an assembled part of IOPC 
itself. The memory page which it occupies in IOPC is the same 
memory page which it will occupy when loaded by the HP2000 ACCESS 
bootstrap. This is to say that when IOPC copies the loader to the 
first file of the separate tape, its absolute record images 
specify this given memory page. Additional instructions are added 
to cause a JMP to the loader from location 4000 which is the 
assumed start address for all programs loaded by the bootstrap. 

The internal flow of the loader program is as follows. The 
program contains three small I/O drivers each of which is non- 
interruptable (SFS logic) . Ihe first of these drivers is a simple 
console output driver. This is used to output operator assistance 
messages. An interconnect kit driver is also included. This 
driver is used to output tfce absolute records read from the 
magnetic tape. to the IOP protected loader. This driver contains a 
timeout procedure which is used to detect a non-operational IOP 
loader. The third driver is, of course, the magnetic tape driver. 
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This driver employs DMA to read the copy of the IOP program from 
tha magnetic tape. 

The loader receives control from the bootstrap* The S 
register is preset by the bootstrap with the magnetic tape select 
code. This select code is configured into all magnetic tape I/O 
instructions. Next, the operator is asked to start the IOP 
protected loader and to signal the completion of this action by 
pressing CB. (Actually, any input is accepted.) A program loop is 
now entered in which tape records are read from the second file of 
tha tape and transferred tc the IOP. (Note that no tape 
positioning is necessary, since the bootstrap program will have 
advanced to the second file by reading the first file which is the 
loader program.) The length of the records read from the tape is 
used to determine the amount of data to be transferred to the IOP. 
If any tape errors occur, an error message is issued, and the 
loader halts. No timeout by the interconnect kit driver should 
occur prior to the occuracce of the tape mark at the end of the 
IOP program copy file. If one does occur, an error message is 
issued, and the loader halts. At the end of the file, zeros are 
loaded into the IOP until a timeout does occur. This will insure 
that the IOP protected loader will go to a normal halt. 

Messages and halt codes used by the loader program are as 
follows: 

START IOP PROTECTED LOADER. PRESS RETORN 

Ihis message is issued tc the operator to inform him that the 
loader program is ready to proceed with loading. The operator 
should at this point insure that the IOP protected loader is 
running and then press CR to signal that the loader may continue. 

IOP IS NOT RESPONDING 

This message indicates that the IOP protected loader has stopped 
accepting data from the loader prematurely. This message is 
followed by a HLT 66. No recovery is possible short of restarting 
the entire loading process from scratch. 

TAPE ERROR 

Some tape error has occurred such as parity, timing, etc. The 
message is followed by a HLT 22. No recovery is possible short of 
restarting the entire loading process from scratch. 
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i££endix B 

Opti onal I CP rel oad procedure 

A yes answer to the RELOAD? question of the initial IOPC 
dialogue ssction indicates tfcat the optional IOP copy file is to 
be loaded into the IOP. Such a copy can be created by IOPC at an 
earlier point in time for use in restoring the IOP program for 
production usa. The flow cf control of the reload process is 
outline below, 

A message is issued to the operator instructing him to start 
the IOP protected loader. Hfcen this is done, the operator signals 
the completion of the acticn by pressing CR. The reload program 
then positions to the optional copy file on the master tap^e. This 
file has ID 65000. Next a loop is entered in which records are 
read from the tape and transferred to the IOP. The magnetic tape 
driver in the MCP and the irterconnect kit driver in IOPC (IOPLD) 
are used to accomplish these actions. The records read from tape 
are in the form cf absolute binary records. The length values in 
these records dictates the amount of data to be transferred to the 
IOP. Several error possibilities exist. If the IOP should fail 
to accept the data, an appropriate message is issued, and control 
is returned to the MCP. If no IOP copy exists on the tape 
(indicated by immediate- tape mark),, an appropriate message is 
issued, and control is returned to the MCP. It is also assumed 
that the magnetic tape driver in the MCP will take appropriate 
corrective action for any tape errors. Normal completion of the 
load process is indicated by forcing the IOP protected loader to 
go to a normal halt. This is done fcy sending zeros to the IOP 
until it fails to respond. Control is then given to the MCP. 
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Accendi x c 
Mai nta^nence .g u id elin es 

There are sone minor and/or obscure details about IOPC and/or 
th.e configured IOP systems which are of importance to maintainence 
personnel, As many of these details which can be remeibered are 
outline below: 



1. A^l modules in the standard modules file are loaded 
into the IOP by ICPC. This is true even if the module 
cannot be located in . NAHT. Only those modules from 
the optional modules file will be loaded which are 
required. This can be a handy tool to force-load 
specialty programs such as stand alone memory dumps, 
performance analysis tools, etc. 

2. A simple technigoe tc effect patches in configured IOP 
programs exists. The use of unused base page for the 
location of patches is generally simple. In order to 
place patches on base page, simply patch the second 
word of the .HEM. table to reserve as much base page 
as necessary. This^ocation defines the last word of 
available base page for use in satisfying dynamic 
buffering requests. If this location is modified prior 
to starting the system, the area will never be made 
available to any ether part of the system. 

3. Patches can be made in the configured prcgran prior to 
copying the IOP program to the magnetic tape. This is 
done prior to starting the IOP at location 2002 when 
directed to do so by IOPC. 

4. The cold dump analyzer list is outlined elsewhere in 
this document. When the IOP program is started, the 
address of this fixed length list is placed in location 
3. It can be used tc format cold dumps as well as to 
examine important control blocks, et. al. in a running 
system (with DUH) . 

5. Although there are several control blocks which are not 
assembled, these same control blocks can te easily 
located. Examples are the .COH., QITs, EQTs, and 
SCOLs. Finding most of these control blocks is done as 
follows: 

• COM. is found via its .COM. entry point. 
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QITs can be located using the QIT summary in the IOPC 
report. 

EQTs can be located using the I/O linkage list in the 
IOPC report, 

SCOLs and BPRTs are located by finding the PULPT entry 
point. At that Iccaticn are the three addresses of the 
SCOL tables. These, in turn, address the BPETs. ■'■'■'■ 

The .DVTB and .CAT tables may be found via their 
respective entry points. 
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Ap pendi x D 

Restri ct ions on reloca ted m odules 

-'The TOT program modules, which IOPC configures into a running 
system; are expected to be assembled following certain guidelines. 
Tlvese are: ■ 

1. If the module is a driver or handler which depends on 
some I/O unit reference number (select code or IOC 
logical unit nuaber) , this number can be merged into 
I/O instructions and parameter words by ICEC. This 
will allow the module to be written excluding 
initialization code normally intended to perform this 
activity. The . aethod by which this is dene is to 
assemble each suck instruction or parameter word with 
its relative select code or IOC unit reference number. 
Host drivers, for example, which use only one select 
code will assemble all I/O instructions using a zero 
select code* Those which depend on two or more should 
be assembled using for the first, 1 for the second, 
and so on. In addition, all such instructions must be 
identified with an entry point of the form ".SCxx" or 
".LUxx" for select codes and logical * units 
respectively. (The ,, xx w may be any unique characters.) 
IOPC will add the base select code or unit number to 
these instructions when configuring the IOP program. 

2. The names assigned to program modules are very 
important. All mcdule selection is on the basis of the 
name found in the NAN statement. In addition, certain 
parts of names are expected to have certain forms for 
IOPC use: 

Variant RJE modules are expected to reflect themselves 
via different names consisting of a basic module name 
and a version indicator. For example, the synchronous 
function handler is expected to have the name "SO" 
followed by either "IB" for the IBM version or "CD" for 
the CDC version. Thus, "SYNIB" or "SYNCD" will be 
appropriately selected by IOPC. 

The first three characters of all function handler 
module names are csed to generate corresponding module 
entry point names for prime, I/O complete, and 
initiator entry pcints. Por example, the SYNIB module 
is expected to have entry points with names "SYNHP", 
"SYNHC", and "SYNHI". Of course, these entry points 
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are not needed if the module does not require the 
respective type of en^ry point. 

For handlers which ; c may be replicate^, ■■■■* the « third 
character of the raice as well as the third .char act ar^At- 
entry point names is expected to be a digit. lThus # ^£<Sr, 
example, the card reader handler module has a * name" of 
CRO and entry Feints CR0HI e CROHG, and^CHOHP. IOPC 
will increment these digits each time a! module is 
replicated, 1 

For drivers which* may be replicated, the fifth 
character of the r.ame as we;ll as the fifth character of 
entry point names is expected to be a digit. Thus, for 
example, the card reader driver mod ule has- a name of 
D. 1 10 and entry points of D.110, I. 1 10 ^and P. 1 10. 
IOPC increments the^o digits for each copy of the 
module. 
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